GitHubのStacked Pull Requestを試してみた(2)
この記事には一部仮説が存在します。 こんにちは 最近、クラフトビールにハマりすぎて、クラフトビールが盛んな街に引っ越した小林です。 前回はStacked Pull Requestの概要に関して、記事にしました。 GitHubのStacked Pull Requestを試してみた(1) 今回は現在の業務で困っていることに対して、役立つのかを検証します。 困りごと 現在、私は現場でシステムの移行を行っています。 製品ごとに順次移行をしているのですが、製品の種類が多く、何度も同じような作業をする必要があります。 簡略化していますが、大まかにはこのような感じで、強い依存関係がある作業です。 一人で作業する分にはさほど問題がなくても、チームで作業するとなると、他のメンバーの作業を待つ必要があったりと大変です。 また、現場のルールとして、Pull Request(以下、PR)をマージする際はスカッシュマージをすることになっています。 そして、複数人、かつAIを利用して開発しているので作業スピードがとにかく早い(=PRが大量に作成される)のです。 つまり、 依存関係のあるPRが大量に作成され、下位のPRをスカッシュマージするとコミット履歴が変わるため、上位ブランチのrebase作業が必要になる ということです。 実際にこのrebase作業でかなりの時間が奪われてしまっています。 検証 rebase自体はGitHubが行ってくれるということは前回の記事でわかりました。 (この時点でStacked Pull Requestを使用することに大きなメリットがあります) 今回検証するのは、以下の2点です。 スカッシュマージをした際にも、rebaseしてくれるのか 並列でStacked Pull Requestを作成することができるのか スカッシュマージをした際にもrebaseしてくれるのか 実はこれの回答はすでに公式ドキュメントに記載されています。 スタックは、3 つのマージ メソッドすべてをサポートしています。 いずれの場合も、pull requests は 1 つのアトミック操作として反映されます。 引用: https://docs.github.com/ja/pull-requests/reference/stacked-pull-requests#merge-methods つまり、スカッシュマージした場合でも自動的にrebaseされると考えられますが、せっかくなので検証してみましょう。 feature1ブランチをスカッシュマージしたところ、feature2ブランチ、feature3ブランチともにrebaseされていることが確認できました。 並列でStacked Pull Requestを作成することができるのか 複数人で開発していると、同じブランチからそれぞれブランチを切り、開発する場合があります。 そのため、同じ下位ブランチに依存する複数のスタックを作成できるのかを検証します。 feature3→feature2→feature1→mainというstackを作成した後に、feature4→feature1→mainというstackを作成したところ、エラーになってしまいました。 すでにスタックに登録されているブランチを別のスタックにも登録できないようです。 別のユーザーでスタックを作成できるのか スタックに登録済みのブランチを別のスタックにも登録できないのは、1ユーザーでなのか、それとも全ユーザーでなのかを検証します。 別のユーザーで新しいブランチとPRを作成し、スタックを設定したところ、無事設定できました。 現在、以下のような構造になっているので、feature1ブランチをベースブランチにマージした際にfeature2ブランチとfeature4ブランチにcommit Fが含まれていれば問題ありません。 feature1ブランチをマージしたところ、feature2ブランチはrebaseされたのですが、feature4ブランチはされませんでした。 ベースブランチをfeature1ブランチにしたらどうなるのか feature1ブランチをスタックの一部ではなく、ベースブランチにしてみたら、どうなるのかを試してみます。 スタック自体は作成できました。 しかし、feature1ブランチをマージしても、feature2ブランチはrebaseされるのですが、feature4ブランチはされませんでした。 gh stack sync GitHub CLIのstackコマンドにはsyncというサブコマンドが用意されています。 このコマンドを実行したところ、feature4ブランチがrebaseされていることが確認できました。 ※feature1ブランチをマージし、feature2ブランチがrebaseされている状態でコマンドを実行しています。 カスケードリベース。 trunk に更新があった場合にのみ、すべてのスタックブランチを更新後の親ブランチにリベースします。 競合が検出された場合、すべてのブランチは元の状態に復元され、 gh stack rebase を実行して競合を対話形式で解決することをお勧めします。 引用: https://docs.github.com/ja/pull-requests/reference/stacked-prs-cli-commands#gh-stack-sync コマンドのマニュアルによるとカスケードリベースという処理があり、これはトランク=スタックのベースブランチに変更があった場合にrebaseをするというものです。 同一ブランチが複数のスタックに関連づけられている場合の挙動に関して言及している公式ドキュメントが見つからず、以下はあくまでも実際の動作結果からの仮説です。 feature4が属するスタックのベースブランチ(feature1ブランチ)は、マージ後にリモートから削除されています。 この状態の変化が検出され、feature4ブランチに対してもrebaseが実行されたのではないかと考えています。 ただし、gh stack syncが具体的にどのような変更を検出し、rebaseを実行したのかは確認できていません。 結論 これらの検証で以下のことを確認できました。 スカッシュマージをした場合でも、上位ブランチは自動的にrebaseされる 同一ユーザーで、既存のスタックに含まれるブランチを別のスタックにも登録しようとするとエラーになる そのブランチを別のスタックのベースブランチに指定することで、スタックを作成できる 別のスタックに属するブランチが自動的にrebaseされなかった場合でも、今回の構成ではgh stack syncを実行することでrebaseできた 完全な自動化は今回の構成では実現できませんでしたが、従来は手動で行っていたrebase作業の一部を自動化できることが確認できました。 そのため、現場でもStacked Pull Requestを利用し、rebase作業の負担をどの程度軽減できるか試してみたいと思います。 参考資料 公式ドキュメント Stacked Pull Request スタックされたプルリクエストの CLI コマンド
GitHubのStacked Pull Requestを試してみた(1)
こんにちは 最近、REALFORCEの分割キーボードが発売されて、つい買ってしまった小林です。 さて、今回は2026年7月にGitHubでパブリックプレビューとして公開され、10月に正式リリースされたStacked Pull Requestという機能について紹介します。 はじめに 業務で困っていることがあり、「Stacked Pull Requestを利用すれば、解決するのではないか」と言われたので、調べてみました。 今回はStacked Pull Requestを解説していき、業務での困りごとについては次回の記事で取り上げたいと思います。 Stacked Pull Requestとは スタックは、同じリポジトリ内の一連のプル要求です。各プル要求は、その下のプル要求のブランチを対象とし、1 つのブランチ (通常はメイン ブランチ) に配置される順序付きチェーンを形成します。 引用: https://docs.github.com/ja/pull-requests/reference/stacked-pull-requests Stacked Pull Requestの機能がなくても、依存関係にあるブランチからPull Request(以下、PR)を作成すること自体は今までも可能でした。 Stacked Pull Requestでは、依存関係をGitHubの仕組みとして管理できるようになり、 一連の小さなプル要求を取得します。 各プル要求には独自のフォーカスされた差分があるため、チームメイトは各レイヤーを個別に確認して承認できます。 引用: https://docs.github.com/ja/pull-requests/reference/stacked-pull-requests 差分の大きな変更を小さなPRに分割しやすくなり、レビューのコストを下げることができる というものです。 何ができるのか まず、以下のような構造のブランチを切り、依存関係のあるPRを作成します。 feature1ブランチ: mainブランチから切られている feature2ブランチ: feature1ブランチの途中のコミットから切られている feature3ブランチ: feature2ブランチから切られている Stacked Pull Requestの設定方法に関しては後述しますが、設定を行うと各PRが以下のような表示になります。 下位のPRをマージした場合 上位のブランチを自動的にrebaseする feature1ブランチのPRをマージすると、feature2ブランチは自動的にrebaseされます。 マージ前後のコミット履歴を比較すると、rebaseにより履歴が更新されたことを確認できます。 feature2ブランチから切られているfeature3ブランチもrebaseされていることが確認できます。 上位のPRをマージした場合 ※feature1ブランチはマージ済みです。 下位のPRもまとめてマージする feature3ブランチのPRをマージするとfeature2ブランチのPRもマージされる。 ベースブランチにfeature2ブランチの内容とfeature3ブランチの両方がマージされていることが確認できます。 結論 この機能は冒頭で述べたように、「差分の大きい変更を分割し、レビューコストを下げる」ことだけでなく、 下位のPRをマージした際に、上位ブランチへの変更の反映と依存関係の維持を自動化する ことができます。 特に自動化に関しては、これまで人が手動で対応していた作業をGitHubが自動で行ってくれるため、手間が減ることが期待できます。 Stacked Pull Requestの設定方法 GitHub CLIから設定する場合 ※CLIで設定するためには、サブコマンドのstackをインストールする必要があります。 1. スタックを初期化し、最下位のブランチを指定する gh stack init {first_branch_name} or gh stack init ※最下位のブランチを指定しなかった場合、対話形式で指定を促されます。 ベースブランチをデフォルトブランチ以外に設定したい場合は--baseオプションを使用します gh stack init --base {base_branch_name} {first_branch_name} 2. ローカルのスタック情報をGitHub上に同期する gh stack submit ※2層目のブランチが未指定の状態では、1層目のブランチのPRにはスタックの情報は表示されません。 3. 現在のスタックに上位のブランチを追加する gh stack add {second_branch_name} 4. ローカルのスタック情報をGitHub上に同期する gh stack submit ※submitした際に対象のブランチのPRが作成されていない場合は、作成用のウィザードが開きます 1〜4の作業をまとめて行う gh stack init --base {base_branch_name} {first_branch_name} {second_branch_name} gh stack submit 他にもコマンドが用意されているので詳細はマニュアルを参照してください。 PRの画面から設定する場合 1. Preview stackを押下する 2. Create stackを押下する 3. 完成 参考資料 公式ドキュメント Stacked Pull Request スタックされたプルリクエストの CLI コマンド
例示用・テスト用ドメインについて知る
こんにちは。豊田です。 前回は、例示用IP・テスト用IPアドレスについてブログを書きました。 例示用IPアドレスについて知る 上記ブログでも触れていますが、私たちは職業柄IPアドレスよりもドメインを使うケースが多いのですが、実はドメインについても代表格である"example.com"(とその他少し)しか知らないのでは?と疑問に思ったので、調べてみました。 はじめに結論 テスト用・例示用のドメインが用意されていることを知りました。(RFC2606 , RFC6761) 特に以下は、今回気になっていた例示用・テスト用のドメインです。 ドキュメント例示用途向け .example TLD例示用 .example.com / .example.org / .example.net セカンドレベルドメイン例示用 .jpドメイン .example.jp / .example.co.jp / .example.ne.jp 以下のバリエーションもある .example1.jp ~ .example9.jp .example1.co.jp ~ .example9.co.jp .example1.ne.jp ~ .example9.ne.jp ドメイン名例.jp 日本語ドメイン版 xn--eckwd4c7cu47r2wf.jp "ドメイン名例.jp"のpunycode テスト用途向け .test DNSやネットワークのテスト用途として予約されている テスト用途で予約はされているものの、本当にネットワークを介したテストを実施するのであれば、当然DNSの設定は必要になるので注意が必要 他にも用途別に多くのドメインが予約されています。 気になる方は調べてみてはどうでしょうか?(Wikipediaにも一覧が載っていました) ドキュメント例示用途向けドメイン まずは例示用向けに予約されているドメインを列挙していきます。 .example IANAのSpecial-Use Domain Namesとして定義されているトップレベルの例示用ドメインです。 明示的にトップレベルドメインを示したいときは、こちらを使うのが良さそうです。 このドメインは知りませんでした。覚えておこうと思います。 .example.com / .example.org / .example.net 同じくIANAのSpecial-Use Domain Namesに定義されている、セカンドレベルドメインです。 多くの人は.example.comに馴染みがあると思いますが、.org, .netも予約されていたのは初耳でした。 通常は.example.comを使いつつ、別のセカンドレベルドメインも例示するときには、こちらを使うのが良さそうです。 jpドメイン .example.jp / .example.co.jp / .example.ne.jp .jpドメインにおける例示用に予約されているドメインです。 .example.jp、.example.co.jpは使えると知っていましたが、.example.ne.jpも使えるとは知りませんでした。 .ドメイン名例.jp(punycode: xn--eckwd4c7cu47r2wf.jp) こちらも知りませんでした... マルチバイト文字の例示用ドメインです。 こちらも、もしかしたら必要になるケースがあるかもしれないので、覚えておいても良さそうです。 テスト用途向けドメイン 次はテスト用途で予約されているドメインです。 こちらは一つだけです。 .test DNSやネットワークのテスト用途として予約されたドメインです。 ネットワークを介するテストをする(独自にDNSなどを設定して運用するような)場合は、こちらを使うことが推奨されています。 というのも.testドメインは、その名前解決リクエストに対して基本的にエラー応答を返すよう、DNSの管理・運用者に要求しています。(RFC6761の6.2.4) そのため、誤ってグローバルネットワークに出てしまうようなテストを書いたとしても、より上位のDNSからは「そんなドメイン知らん」と言われるだけで、ネットワークに不要な負荷をかけないような仕組みになっているからです。 限られたネットワーク内で完結することを想定したテストであれば、.testをテスト用途で使って良い。ということのようです。(しつこいですが、DNSの設定等は独自にちゃんとやっておく前提です) 専用ドメインを取得していない(これから取得する)ようなケースなどでは、非常に有効な手段となりそうです。 おまけ その他にも色々とドメインが予約されていますが、その中で .invalidというドメインは興味深かったです。 こちらは「無効なドメイン」を示すドメインであり 誤って外部にリクエストを送ってしまう可能性のある設定の初期値 名前解決に失敗することを期待するテスト 無効なURLの例示 ダミーメールアドレス といった場面で利用できます。 まとめ 例示用・テスト用のドメインについても知らないドメインがいくつかありました。(他の用途で言えば、もっとたくさん専用ドメインが予約されていました) 多くの場合.example.comで事足りてしまうことが多いですが、知識の引き出しとして覚えておくと、助かる場面があるかもしれません。
JRRF2026に参加してきました
こんにちは、小林です。 去年に引き続き、今年もJRRFに参加してきました!! https://japanreprapfestival.com/ 去年の参加レポートはこちらです。 JRRF2025に参加してきました 去年も大盛況でしたが、今年はさらに大規模なイベントになっていました。 キャパシティ: 970人 → 2,000人 出展ブース数: 77ブース → 154ブース 来場者数: 1,500人 → 4,700人(両日参加者を1人とした場合、3,300人) 会場も東京流通センターのホールCからホールEに変更され、全体的にかなりスケールアップしていました。 今年は展示スペースだけでなく、イベントや体験スペースが充実しており、3Dプリンターをまだ持っていない方でも楽しめる内容になっていました。 MakerChip 3Dプリンター界隈では、もはやお馴染みとなったMakerChip。 開催の数週間前から、多くの方々がオリジナリティあふれるデザインで印刷をしている様子がXのタイムラインを賑わせていました。 もちろん、私も印刷しました。去年はY軸で回転させたので、今年はZ軸で回転するようなデザインにしました。 今年は100個用意し、全て交換してきました。ブースにいる方々だけではなく、一般参加の方とも交換をし、交流を深めることができました。 UVプリンターとレーザー刻印 参加されている方のMakerChipはどれもすごいのですが、特に気になったのがこの3つです。 左から、DaDaDa3Dprint(@DaDaDa3D)さん(企業)、Mithril_MEX(@Mithril_MEX)さん、大阪@スリキャン(@3dp_oosaka)さんのもので、左の2つはUVプリント、右の1つはレーザー刻印が施されたものです。 レーザー刻印はやはり0.2mmのノズルとは比べ物にならないくらい精密なものを描画できるので憧れます。 UVプリンターもこんなに綺麗に印刷できるのかと、驚きました。使ってみたいのですが、個人で購入するにはまだ少しハードルが高いです。 キッチンカー なんと、今年は会場内にキッチンカーが出店していました。 去年はカロリーメイトを片手に栄養補給をしていたので、とてもありがたいです。 私はBLACK BURGERさんのハンバーガーを食べてきました。 バンズが真っ黒なのは、竹炭を練り込んでいるからだそうです。 ブース 今年はブース数が多く、目移りしてしまうほどでしたが、特に気になったブースを紹介します。 歩く3Dプリンター ぼんじー(@bonjyy)さんのRepRap作品の歩く3Dプリンター。 https://x.com/bonjyy/status/2060904588405088351?s=20 最初に見かけた時は、ヘッドがレール上をベルトやワイヤーで移動するのではなく、関節を動かして印刷するのかと思い、単純に駆動方式の違いに驚いていました。 しかし、よく見ると本当に歩いていて、さらに驚いてしまいました。 これを見た時、スター・ウォーズに登場するAT-ATウォーカーにしか見えませんでした笑 電解メッキ HEN3DRIK(@HEN3DRIK)さんはドイツで電解メッキと表面仕上げを研究しているとのことです。 どの作品も金ピカだったのですが、特にC-3POの頭部が一際目立っていました。 こちらがHEN3DRIKさんが作成されたMakerChipなのですが、3Dプリンターと組み合わせるとこんな感じになります。 https://x.com/HEN3DRIK/status/2058226348376613357?s=20 どちらも技術としてすごい!!と思うと同時に、スター・ウォーズファンの私としてはニヤリとしてしまう展示でした。 感想 今年も本当に大盛況でした。イベントやブース、キッチンカーと見るものが多く、1日で見たいものを全て見るのは無理でした。 来年は、2日間両方参加しようと思います。 きっと来年はさらに盛り上がるイベントになりそうで、今から楽しみです。
例示用IPアドレスについて知る
TL;DR IPアドレス(v4, v6)にはドキュメントへの記載用のアドレスが予約されています。(RFC5737 / RFC3849) ドキュメントに記載するアドレス際は、適切な専用のIPアドレスを使いましょう。 素朴な疑問 弊社ではwebアプリケーションの開発をおこなっています。 そんな業務の中で、先日「IPアドレスでの入力はinvalidにする(ドメイン名での入力を求める)」というケースの実装をすることがありました。 実装を終え、いざテストを書こうとしたときに、テストで使えるIPアドレスを知らないことに気づきました。(職業柄、ドメイン名(example.comなど)を扱うことはあってもIPアドレスを扱うケースは多くないので...) その時に調べた例示用IPアドレスについて、まとめておこうと思います。 IPv4 RFC1166 例示用IPv4アドレスはRFC1166で登場しました。 当初は192.0.2.0/24のみでした。 また、「例示用」という明確な定義はなく、"TEST"というネットワーク名が付けられている。というくらいの曖昧な位置づけだったようです。 ※ 一応、研究用途であることや、インターネットでは利用されない前提であることは決まっていたようです。 RFC5737 例示用のIPv4アドレスに関しては、RFC5737が最新です。 こちらでは、以下の3つアドレスブロックを例示用と位置づけています。 192.0.2.0/24 (TEST-NET-1) 198.51.100.0/24 (TEST-NET-2) 203.0.113.0/24 (TEST-NET-3) 上記のアドレスブロックは、明確に「例示用」とされており、ルーターやファイアウォールなどのネットワーク機器で「外部ネットワークに出さない/内部ネットワークに入れないIPアドレス」とすることをネットワーク運用者に求めています。 つまり、(誤って)実際のプログラムで使われてしまっても、外部ネットワークに出ていかない安全なIPアドレスということになります。 「例示用」の位置づけですが、IPアドレスとして機能しないものであり、テストでの利用も問題ありません。 128.66.0.0/16 少し脱線しますが、RFC5737の5章では、128.66.0.0/16というIPアドレスが過去に例示用に使われたことに言及しています。 このIPアドレスは現在、特別な意味を割り当てられていないため通常のIPアドレスとして(注意すれば)使って良い。とされています。 あまり気にする必要は無さそうですが、古い設定などが残ってる環境などは、意図しない挙動になる可能性があるので、少し注意しておく必要はあるかもしれません。 IPv6 RFC3849 IPv6の例示用アドレスはRFC3849で定義されています。 2001:db8::/32 です。 IPv4同様、インターネット上にパケットが流通しないように、ネットワーク運用者が管理することが求められています。 RFC9637 比較的最近(2024年)、RFC3849を拡張する形でRFC9637が定義されました。 3fff::/20 です。 RFC3849で定義されている2001:db8::/32はネットワーク部で32bit使っており、より大規模なネットワークを例示するユースケースで使えない。という問題があったようです。 なぜネットワーク部を20bitとしたのかについては、3章で具体的に説明されていました。(現在の利用状況から20bitとしておけば、将来的にも困らないだろう...ということのようです) まとめ 長年この業界にいますが、example.comだけで困らなかったので、久々に「へーちゃんと用意されてるんだ」と感じました。 テストやドキュメントを書くときは、RFCに従って書いていきましょう!

