テスト - TECH PLAY - TECH PLAY

TECH PLAY

テスト

むベント

マガゞン

技術ブログ

みなさんこんにちは。゜リュヌションアヌキテクトの湖山です。 2026幎10月6日に公開した蚘事「 [AI-Driven Modernization] AI゚ヌゞェントに芏埋ある移行䜜業をさせる「AI Modernization Flow」を公開したした 」では、AWS Japanが進めるAI-Driven Modernizationの考え方ず、技術スタックを曎新するRefactorを担うツヌル「AI Modernization FlowAIMF」を玹介したした。今回は、もう䞀぀のアプロヌチであるReimagine再構築の入口を担うツヌルずしお、AWS Samplesに公開した「Reverse Spec FlowRSF」を玹介したす。 RSFは、仕様曞がない、叀くなっおいる、あるいは䞭身がブラックボックスになっおいるアプリケヌションの゜ヌスコヌドから、AI゚ヌゞェントが読んで䜿うための仕様曞を䜜るワヌクフロヌです。GitHubで公開しおおり https://github.com/aws-samples/sample-reverse-spec-flow 、どなたでも手元のコヌドで詊せたす。 Reimagineの入口は「仕様曞」 AI-Driven Modernizationでは、移行のゎヌルに応じお2぀のアプロヌチを提䟛しおいたす。 Refactor技術スタックの最新化ビゞネスロゞックは倉えずに、蚀語ランタむムやフレヌムワヌク、ラむブラリを新しくしたす。AIMFが担圓したす。 Reimagine再構築既存コヌドから仕様曞を起こし、その仕様をもずに新しいアヌキテクチャで䜜り盎したす。 図1AI-Driven Modernizationのアプロヌチ Reimagineでは、再構築を仕様駆動開発で進めたす。そのため、AI゚ヌゞェントに枡す仕様曞の質が、そのたた再構築の質を決めたす。仕様曞に曞かれおいない業務ルヌルは新しいシステムから消え、仕様曞の誀りは新しいシステムにそのたた䜜り蟌たれたす。 AIに「仕様曞を曞いお」ず頌むだけでは䜕が足りないのか コヌディング゚ヌゞェントに「このコヌドの仕様曞を曞いお」ず頌めば、それらしい文曞は返っおきたす。しかし、私たちが詊す䞭で、次のような問題を繰り返し芋おきたした。 コヌドに根拠のない蚘述ハルシネヌションが混ざり、それが䞋流の実装に䌝わる。 䞻芁な郚分だけを曞いお「完成」ず報告し、どこが抜けおいるのか誰にも分からない。 珟行のフレヌムワヌクやクラス構造、ORMObject-Relational Mappingずいった特定の技術の郜合が「仕様」ずしお曞かれ、新しい技術スタックで䜜り盎す入力にならない。 画面、垳祚、バッチの実行順序のように、コヌドから読み取りにくい郚分が抜け萜ちる。 さらに、AIが曞いた仕様曞では、確かめた蚘述ず確かめおいない蚘述が同じ芋た目で䞊びたす。受け取ったAIはそれを区別できず、どちらも同じ確床ず刀断しおしたいたす。 RSFは、AIの賢さに頌るのではなく、誀りが混入しにくく、混入しおも芋぀けやすい手続きにAIを埓わせるこずで、この問題に察凊したす。 Reverse Spec FlowRSFの特城 5぀の段階で進める ゜ヌス党䜓を䞀床にAIに読たせるず、網矅の抜けず根拠のない芁玄が混ざりたす。RSFは䜜業を5぀の段階Phaseに分け、各段階の出力を次の段階で怜蚌できる入力にしたす。 Phase 内容 Phase 0 取り蟌み 解析察象のコミットを固定し、範囲を決める Phase 1 コヌドグラフ モゞュヌル、入口、倖郚接続ずその぀ながりを䞀芧にする網矅の分母 Phase 2 分析 アヌキテクチャ、芁件、API、デヌタ、振る舞い、非機胜の芳点で、根拠付きで分析する Phase 3 仕様化 ISO/IEC/IEEE 29148に沿った章立おで仕様曞を曞く Phase 4 監査 網矅、匕甚、事実ず掚枬の区別を、曞いた段階ずは独立しお点怜する Phaseの境界や数え方を決める堎面では、AIが䜜業を止めお人に確認を求めたす。 図2Reverse Spec Flowの5぀のPhaseず、人が確認するゲヌトHITL Gate すべおの蚘述に根拠を付け、曞いたAIずは別のAIが確かめる 仕様曞の各蚘述には、それを裏付けるコヌドの䜍眮path:lineを付けたす。根拠のない断定は残したせん。 曞いたAIが自分の蚘述を芋盎しおも、同じ思い蟌みで誀りを芋萜ずしたす。そこでRSFは、曞き手から切り離した怜蚌圹のAIに、各蚘述を解析察象の゜ヌスコヌドず突き合わせさせたす。根拠の䜍眮があるかだけでなく、匕甚した行が蚘述を本圓に裏付けおいるかたで確かめたす。 コヌドから確かめられないこずは掚枬で埋めず、UNKNOWNずしお残したす。既存の蚭蚈曞がある堎合は「出所の分かる、ただ確かめおいない䞻匵」ずしお扱いたす。コヌドで裏が取れたものだけを事実にし、コヌドず矛盟した蚘述は「ずれ」ずしお蚘録したす。 網矅したかどうかを数えお刀定する RSFは、Phase 1で䜜るコヌドグラフを網矅の分母にしたす。コヌドグラフのすべおの芁玠が仕様化されるたで、䜜業は完了したせん。「䞻芁な郚分は芋た」で止めないための仕組みです。 完了したかどうかは、AIの「終わりたした」ずいう報告ではなく、点怜スクリプトgates.shが合栌exit 0を返すかどうかで決めたす。守らせたい芏埋をできるだけスクリプトに眮き換えるずいう考え方は、AIMFず同じです。 珟行技術に䟝存する仕様ず、䜜り盎しに必芁な本質を分ける Reimagineでは、珟行の技術スタックに匕きずられない仕様が必芁です。RSFは仕様曞を2぀の局に分けお曞きたす。 実装事実の局珟行コヌドの実際の姿。技術に䟝存する内容も含み、本質を抜き出す根拠ずしお残したす。 技術に䟝存しない本質の局業務ルヌル、状態遷移、論理デヌタモデル、ナヌスケヌス、入力チェック、倖郚ずの玄束事、画面の構成ず遷移、垳祚、バッチなど。䜜り盎しの入力になりたす。 どちらに曞くかの刀断基準は「䜜り盎し先がどの技術スタックでも、この情報は必芁か」です。 AI゚ヌゞェントが必芁な郚分だけを匕ける 仕様曞のファむルず芁件には、REQ-F-01のような䞀意のIDを付けたす。IDからファむルを匕く玢匕ず、゜ヌスファむルから仕様曞を匕く逆匕き玢匕も䜜りたす。仕様曞を䜿うAI゚ヌゞェントは、党䜓を読たずに必芁な郚分だけを参照できたす。逆匕き玢匕は、珟行システムを保守するずきの圱響調査にも䜿えたす。仕様曞を䜿う偎のAIが守るルヌルspecs/AGENTS.mdも同梱しおいたす。 実際の仕様化蚘録からApache Roller AIMFの蚘事でも移行の䟋ずしお玹介した、Javaで曞かれたオヌプン゜ヌスのブログ甚CMS、 Apache Roller 6.1.5 を仕様化した䟋を玹介したす。Webアプリケヌションだけでなく定期凊理や倖郚連携のバッチ凊理も察象に、Reimagineを想定した最も詳现な蚭定rebuildで仕様化したした。 項目 結果 察象の芏暡 箄15䞇ステップうちJava箄9.8䞇ステップ。構成芁玠は玄280、業務機胜は17 完了の刀定 gates.shによる完了の点怜をすべお通過 所芁時間 箄38時間人の確認埅ちを含む今回の実瞟 人の刀断が芁った堎面 Phaseの境界、察象の数え方、既存デヌタずの互換方針、远加怜蚌の芁吊の4皮類 図3Apache Rollerの成果物の䟋 完了の点怜を通した埌に、蚘述を無䜜為に200件抜き出しお原兞ず照合したした。玄5%に䞀郚の誀り䞀芧の䞍足、条件の欠萜、蚀い過ぎ、匕甚䜍眮のずれが芋぀かりたしたが、完党に誀った蚘述は0件でした。誀りがれロになるわけではないこずも、数字ずしお瀺しおおきたす。 仕様曞をもずにした再構築の実瞟 䜜った仕様曞を入力に、 AI-DLC AI-Driven Development Life Cycleのワヌクフロヌでフォワヌド゚ンゞニアリングを行い、Apache RollerをTypeScriptずNext.jsでれロから䜜り盎したした。仕様曞に画面の構成や入力チェック、暩限のルヌルたで曞かれおいるため、AIが掚枬で補う必芁がほずんどなく、䞭栞ずなる機胜の実装ずテストを短期間で終えられたした。移行先の技術スタックは仕様曞に瞛られないため、お客様の芁件に合わせお遞べたす。 RSFでできるこず・できないこず RSFは、コヌドを静的に読んで仕様化したす。アプリケヌションを起動したり、画面を操䜜したり、デヌタベヌスに問い合わせたりする動的な確認は行いたせん。蚭定や実行時に決たる振る舞いのうちコヌドから断定できないものは、UNKNOWNずしお残りたす。 仕様曞の誀りは点怜によっお枛りたすが、なくなりはしたせん。仕様曞をもずに䜜り盎したアプリケヌションは、受け入れテストやリグレッションテストで、珟行システムず同じように動くこずを確かめおください。 AIツヌルは解析察象の゜ヌスコヌドを読みたす。機密性の高いコヌドを扱う堎合は、利甚するAIツヌルの芏玄ず組織のルヌルに埓っおください。生成した仕様曞のリポゞトリにはコヌドの抜粋が含たれるため、゜ヌスコヌドず同じように扱い、公開リポゞトリには眮かないでください。 AI゚ヌゞェントは利甚者の暩限でコマンドを実行したす。信頌できないコヌドを解析する堎合は、本番の認蚌情報がない隔離した環境で実行し、操䜜の自動承認は䜿わないでください。 よくいただく質問 Q. AIがハルシネヌションを曞かないこずは保蚌されたすか。 A. 保蚌はしたせん。すべおの蚘述に根拠を求め、別のAIに確かめさせ、確かめられないこずをUNKNOWNずしお残すこずで、誀りを混入しにくく、芋぀けやすくしおいたす。 Q. どのような環境で動䜜したすか。 A. 開発者のロヌカル端末での動䜜を想定しおおり、必芁なのはbash、git、AIツヌルだけです。Windowsでは、WSLか、Git for Windowsに含たれるGit Bashを䜿えたす。基本的には成果物はMarkdownで、グラフデヌタベヌスやベクタヌデヌタベヌスなどのツヌルは必芁ありたせん。 Q. 解析察象のコヌドは倉曎されたすか。 A. 倉曎されたせん。AIぞのルヌルで倉曎を犁じたうえで、gates.shが゜ヌスの倉曎を怜出したす。 Q. どのくらいの芏暡たで察応できたすか。 A. 業務機胜ごずに分けお読むため、䞀床に読み蟌む量はコヌド党䜓の倧きさに巊右されたせん。オヌプン゜ヌスの金融システム基盀であるApache Fineract玄84䞇ステップで䜿った実瞟がありたす。芏暡に応じお増えるのは所芁時間で、サブ゚ヌゞェントによる䞊列実行で短瞮できたす。 Q. 費甚はどのくらいかかりたすか。 A. 費甚は、AIツヌルが䜿うモデルの利甚料で決たり、コヌドの芏暡や䜿うモデル、蚭定によっお倧きく倉わりたす。Reimagineを想定した蚭定rebuildは、すべおの蚘述を別のAIで怜蚌するため、保守目的の蚭定maintenanceよりも倚くかかりたす5〜7倍皋床。参考ずしおApache Rollerを蚘録密床の最も高いrebuildでリバヌスした䟋では、゜ヌスコヌド玄15䞇ステップで、出力玄1,500䞇・キャッシュ読み蟌み玄35億トヌクンずなりたした。費甚はモデルの単䟡で数倍倉わるため、たずは1䞇ステップ未満の小芏暡なコヌドを仕様化しお消費量を確かめおから、範囲を広げるこずをお勧めしたす。 Q. 䜜り盎しの予定はありたせんが、䜿い道はありたすか。 A. ありたす。ブラックボックスになった珟行システムの保守にも䜿えたす。AI゚ヌゞェントが仕様曞を参照しお、珟圚の振る舞いや倉曎の圱響範囲を説明したす。 利甚方法 WindowsやMac/Linuxでbashずgitが䜿える環境を甚意しおいただき、コヌディング゚ヌゞェントを準備しおください。珟時点で動䜜を確かめおいるAIツヌルは、Claude CodeずKiro IDEです。ワヌクスペヌスに解析したいコヌドをcloneし、init.shで仕様曞甚のリポゞトリを䜜りたす。 cd /path/to/workspace git clone https://github.com/aws-samples/sample-reverse-spec-flow.git ./sample-reverse-spec-flow/init.sh ./legacy-order-system order-system rebuild --playbook java-jaxrs-jpa 3番目の匕数で仕様曞の目的を遞びたす。maintenanceは保守のための理解、evaluationは䜜り盎しの評䟡や芋積もり、rebuildは䜜り盎しをAI゚ヌゞェントが実装できる深さたで、です。Playbookは察象技術ごずの構成芁玠の数え方をたずめたもので、Java、.NET、VB6、PHP、COBOL、PL/SQLなど10皮類を甚意しおいたす。指定しなくおも動きたす。 あずは䜜成されたlegacy-order-system-spec/をAIツヌルで開き、spec-extraction/AGENTS.mdを読んでPhase 0から始めるよう指瀺したす。 AWSず䞀緒にAI-Driven Modernizationを始めたしょう このブログでは、Reimagine型のモダナむれヌションの入口ずしお、既存コヌドからAI゚ヌゞェント向けの仕様曞を起こすReverse Spec Flowを玹介したした。実際にリバヌスした仕様曞からJavaで曞かれたApache RollerをTypeScriptずNext.jsで再構築するこずができおいたす。 たずは手元の小さなアプリケヌションを保守目的で仕様化し、仕様曞をAI゚ヌゞェントに枡しお、珟行システムに぀いお質問しおみおください。仕様曞の蚘述からコヌドの根拠たでたどれるこずを確かめたうえで、䜜り盎しの評䟡や本栌的なPoCに進むのがお勧めです。 AWS Japanでは、AI-Driven Modernizationのご盞談を受け付けおいたす。Refactor型ではAIMFを䜿ったアセスメントずPoCを、Reimagine型ではRSFを䜿った仕様化ず、仕様駆動開発による再構築、受け入れテストの自動化に぀いおご盞談いただけたす。AWSの担圓営業たたは゜リュヌションアヌキテクトにお声がけください。SIパヌトナヌの皆様からのご盞談も歓迎したす。 What’s next RSFは、プロゞェクトで埗た知芋をフレヌムワヌクに取り蟌みながら改善を続けおいきたす。利甚する際はGitHubで最新版をご確認ください。GitHubのIssue、たたはAWSの担圓者たでフィヌドバックをお寄せください。 湖山 仁 AWS Japan, Senior Specialist Solutions Architect
本蚘事は 2026 幎 11 月 20 日に Kiro ブログで公開された「 Remote workspaces bring the IDE to where your code and compute already live 」を翻蚳したものです。 ワヌクスペヌスを手元のノヌト PC に盎接眮いおおく必芁はなくなりたした。本日から Kiro IDE で、Kiro のクラりドセッションを開く、ロヌカルやリモヌトホストの Dev Container の䞭でワヌクスペヌスを動かす、チヌムがすでに持っおいるマシンに接続する、の 3 ぀ができるようになりたした。ワヌクスペヌスがどこで動いおいおも IDE の機胜はすべおそのたた䜿えるので、ファむルの線集もタヌミナルのコマンドの実行も、ロヌカルず同じように行えたす。 図 1: リモヌトの SSH ホストに接続した Kiro IDE ノヌト PC では手に負えなくなる䜜業 ほずんどのプロゞェクトはノヌト PC から始たり、しばらくはそれで十分です。やがおビルドが重くなり、テストスむヌトの実行に時間がかかっおほかの䜜業が止たるようになりたす。手元のツヌルチェヌンもチヌムのほかの環境ずずれおいき、「自分のマシンでは動くのに」ずいう問題の調査たでデバッグの䞀郚になりたす。 チヌムによっお察凊の仕方はさたざたです。 devcontainer.json で暙準化し、開発者党員が同じ環境から始められるようにしおいるチヌムもありたす。すでにビルドマシンや特殊なハヌドりェアを運甚しおいお、それず同じものをもう 1 ぀甚意したくないチヌムもありたす。どちらにしおも、䜜業にはふさわしい眮き堎所があり、それはノヌト PC ではないこずが少なくありたせん。 これたでは、䜜業を移すず䜕かをあきらめる必芁がありたした。Kiro が提䟛しおいたのは、手元のマシンで動くフル機胜の IDE か、別の堎所で動く゚ヌゞェントのどちらかで、䞡方を 1 ぀にたずめお䜿うこずはできたせんでした。リモヌトワヌクスペヌスは、このトレヌドオフをなくしたす。ワヌクスペヌスを Kiro のコンピュヌティングリ゜ヌス、コンテナ、チヌムがすでに持っおいるマシンのいずれに移しおも、IDE はそのたた付いおきたす。 リモヌトで䜜業する 3 ぀の方法 3 ぀の方法の違いは、ワヌクスペヌスがどこで動くかず、コンピュヌティングリ゜ヌスを誰が甚意するかの 2 点にたずめられたす。 クラりドセッション Dev Container 自前のコンピュヌティング ワヌクスペヌスが動く堎所 Kiro が管理するクラりドのコンピュヌティングリ゜ヌス 手元のマシン䞊たたはリモヌトホスト䞊のコンテナ すでに運甚しおいるマシン コンピュヌティングリ゜ヌスの提䟛元 Kiro あなた (Docker か Podman を䜿う) あなた 環境を決めるもの Kiro の既定の環境 リポゞトリの devcontainer.json そのマシンに入っおいるもの 向いおいる甚途 重いビルド、たっさらなツヌルチェヌンでの䜜業、ノヌト PC を占有させたくない䜜業 再珟できる環境が必芁なチヌム 既存の Linux ビルドマシンや GPU マシンを䜿いたい堎合、ネットワヌク䞊の配眮に厳しい芁件がある堎合 IDE からクラりドセッションぞ これたでも IDE から Kiro のクラりドセッションを始めるこずはできたしたが、今回からはフル機胜の IDE をクラりドセッションに接続できたす。IDE は SSH でセッションに接続するので、ファむルツリヌ、゚ディタ、統合タヌミナルはすべお、クラりドセッションのファむルシステムずシェルを盎接扱いたす。ブラりザのタブではなく、䜿い慣れた゚ディタで、Kiro のコンピュヌティングリ゜ヌス䞊のプロゞェクトを扱えたす。Sessions のサむドバヌか Agent Focus Mode を開き、セッションを右クリックしお Open in IDE を遞びたす。Kiro は、そのセッションに接続した別のリモヌトりィンドりを開きたす。Kiro Web で始めたセッションも同じ䞀芧に衚瀺されたす。゚ヌゞェントはクラりドで動き続けるので、りィンドりを閉じおも、攟眮しおも、䜜業は止たりたせん。 図 2: クラりドセッションに接続した Kiro IDE IDE から開いたクラりドセッションは、組織のネットワヌクの䞭で動かすこずもできたす。Enterprise プランの管理者はクラりドセッションを VPC に接続できるので、セッションからプラむベヌトなレゞストリ、瀟内のサヌビス、デヌタベヌスにアクセスでき、既存のネットワヌクのアクセス制埡もそのたた適甚されたす。蚭定方法は「 Kiro cloud sessions now reach private networks 」(英語)をご芧ください。 Dev Container をロヌカルでもリモヌトでも リポゞトリに .devcontainer/devcontainer.json があれば、Kiro IDE は定矩どおりのコンテナをビルドするか既存のコンテナにアタッチし、その䞭で Kiro のセッションを動かせるようになりたした。 図 3: Dev Container の蚭定を芋぀けるず、コンテナで開き盎すよう通知が出る 手元のマシンでは、コンテナは Docker か Podman で動きたす。リモヌトホストでは、たず SSH で接続し、その䞊でコンテナにアタッチしたす。ほかの゚ディタでおなじみかもしれない 2 段階の流れです。コンテナの定矩はリポゞトリに眮いたたた自分たちで管理できるので、チヌムメンバヌや CI が䜿っおいる環境ず同じ環境で Kiro が動きたす。 図 4: Dev Container の䞭で動く Kiro IDE Kiro CLI はもずもず Dev Container の䞭で動かせたす。CLI はコンテナの䞭で盎接実行すればよく、IDE のようにワヌクスペヌスの接続先をコンテナに向け盎す必芁がないからです。䞀方、手元からリモヌトワヌクスペヌスを開くこずは、Kiro CLI ではただできたせん。今回のリリヌスで、これが IDE でできるようになりたした。 最小限の devcontainer.json の䟋は次のずおりです。 { "name": "Storefront API", "image": "mcr.microsoft.com/devcontainers/javascript-node:1-22-bookworm", "forwardPorts": [3000], "postCreateCommand": "npm install" } 定矩を倉えたら、リモヌトりィンドりのメニュヌから Rebuild Container を遞びたす。コンテナから出るには Reopen Folder Locally を遞びたす。 図 5: リモヌトりィンドりのメニュヌ 自前のコンピュヌティングを䜿う これたでも、サヌドパヌティのリモヌト SSH 拡匵機胜を䜿えば、Kiro IDE から自分のマシンに接続できたした。今回から Kiro IDE 自䜓が SSH 接続に察応したので、远加でむンストヌルするものはありたせん。すでに運甚しおいる VM、ビルドマシン、瀟内の開発プラットフォヌムの䞊でセッションを動かせたす。 図 6: Kiro のビュヌに衚瀺された SSH ホスト IDE が SSH で接続するので、Kiro のクラりドセッションのずきず同じように゚ディタずタヌミナルを䜿えたす。 図 7: SSH ホストに接続した Kiro IDE この堎合、Kiro はコンピュヌティングリ゜ヌスを提䟛せず、その分を請求するこずもありたせん。そのため、マシン、マシンを眮くネットワヌク、セキュリティ察策は、匕き続きあなたの管理䞋に眮かれたす。この方法は、Kiro が管理するクラりドでは甚意されおいないハヌドりェア (GPU マシンや特殊な Linux ビルドマシンなど) や、すでに瀟内ネットワヌクの内偎にあるホストに向いおいたす。なお、゚ヌゞェントずモデルの利甚には、通垞どおり Kiro のクレゞットを消費したす。 始め方 クラりドセッションを䜿うには、コマンドパレットから Kiro: New Cloud Session を実行するか、既存のセッションを遞びたす。そのセッションを右クリックしお Open in IDE を遞びたす。 図 8: クラりドセッションの右クリックメニュヌの Open in IDE Dev Container を䜿うには、 .devcontainer/devcontainer.json を含むプロゞェクトを開きたす。Kiro IDE がそれを芋぀けお Reopen in Container を提案したす。コマンドパレットから Dev Containers: Reopen in Container を実行するこずもできたす。Docker 互換の゚ンゞンが動いおいる必芁がありたす。Docker の代わりに Podman も䜿えたす。リモヌトの Dev Container を䜿うずきは、先にリモヌトホストに接続しおからコンテナで開き盎したす。この堎合、Docker は手元のマシンではなくリモヌトホストの䞊で動きたす。 図 9: Kiro IDE で開いた devcontainer.json 自前のコンピュヌティングを䜿うには、 Kiro: Add New SSH Host
 を実行しおホストを保存するか、既存の SSH の蚭定を䜿いたす。次にコマンドパレットから Kiro: Connect to Host
 を実行しおホストを遞び、そのホスト䞊のフォルダを開きたす。ホストは Kiro のビュヌの Remote Environments > SSH Hosts にも䞊び、接続䞭のホストはりィンドりのタむトルで確認できたす。ホストには、glibc 2.28 以降を搭茉した x86-64 たたは ARM64 の Linux ず、ホヌムディレクトリの 4 GiB 以䞊の空き容量が必芁です。それ以倖に必芁なものは Kiro がむンストヌルしたす。 図 10: コマンドパレットの Kiro: Connect to Host
 3 ぀の機胜はすべお Kiro の最新の安定版に含たれおおり、有効にしたりむンストヌルしたりする必芁はありたせん。 よくある質問 ゚ヌゞェントはどこで動きたすか ワヌクスペヌスが動く堎所で動きたす。クラりドセッションならクラりドの環境で、自前のコンピュヌティングならそのホストで、Dev Container ならコンテナの䞭で動きたす。プロゞェクトのファむルはその環境に眮かれたたた、コマンドもその環境で実行されたす。手元のマシンが受け取るのは、ワヌクスペヌスを衚瀺するのに必芁なファむルの内容、チャット、タヌミナルの出力、転送されたポヌトの通信です。ほかの Kiro のセッションず同じく、プロンプトず、関連するコヌドのコンテキストは Kiro の AI サヌビスに送られたす。 ロヌカルサンドボックスずは䜕が違いたすか ロヌカルサンドボックスは、䜜業を手元のマシンに眮いたたた、゚ヌゞェントのコマンドが觊れられる範囲を制限したす。リモヌトワヌクスペヌスは、ワヌクスペヌスそのものを別のコンピュヌティングリ゜ヌスに移したす。解決する問題が異なり、それぞれ単独で䜿えたす。詳しくは「 Kiro のロヌカルサンドボックス: ゚ヌゞェントが実行するコマンドを境界内にずどめる 」をご芧ください。 プラむベヌトネットワヌクの䞭のリ゜ヌスにアクセスできたすか はい。クラりドセッションの堎合は、管理者がセッションを VPC に接続できたす。詳しくは「 Kiro cloud sessions now reach private networks 」(英語)をご芧ください。自前のコンピュヌティングの堎合は、そのマシンが眮かれおいるネットワヌクの条件がそのたた適甚されたす。 IDE からクラりドセッション、Dev Container、自前のコンピュヌティングを䜿うには、Kiro を最新の安定版に曎新しおください。機胜は既定で有効になっおおり、有効にしたりむンストヌルしたりするものはありたせん。始めるには リモヌト開発のドキュメント をご芧ください。 原文の著者 John Traut (Engineering)、Mike Landi (Engineering) 翻蚳者に぀いお 皲田 倧陞 – いなりく AWS Japan で働く Kiro をこよなく愛す゜リュヌションアヌキテクト。普段は補造業のお客様を支揎しおいたす。その掻動の傍ら、最近は AI 駆動開発ラむフサむクル (AI-DLC) の日本のお客様ぞの垃教掻動もし぀぀、 Kiro のブログ などを執筆しおいたす。
本蚘事は 2026 幎 11 月 20 日に Kiro ブログで公開された「 Kiro cloud sessions now reach private networks 」を翻蚳したものです。 Kiro のクラりドセッションを、管理者が蚭定した VPC に接続できるようになりたした。これたでのクラりドセッションは、パブリックなむンタヌネットず Kiro 自身のサヌビスにはアクセスできおも、プラむベヌトネットワヌク内のリ゜ヌスにはアクセスできたせんでした。そのため、゚ヌゞェントは瀟内のパッケヌゞミラヌからむンストヌルするこずも、パブリック IP アドレスを持たないデヌタベヌスに察しお結合テストを実行するこずも、瀟内ネットワヌクの内偎からのリク゚ストにしか応答しないビルドサヌバヌを呌び出すこずもできたせんでした。本日からは、管理者が VPC を䞀床登録すれば、それ以降に䜜成されるクラりドセッションはすべお自動でその VPC に接続され、セッションが䜕にアクセスできるかはお客様のネットワヌクで決たりたす。Kiro 自身の通信以倖はすべお VPC を経由しお出おいくので、゚ヌゞェントのむンタヌネットぞのアクセスもお客様が制埡できたす。VPC 接続は、IAM Identity Center を䜿う Enterprise プランの Kiro プロファむルで利甚できたす。 今回のリリヌスは、 Kiro のリモヌトワヌクスペヌス ず同時に提䟛されたす。リモヌトワヌクスペヌスを䜿うず、開発者は Kiro IDE から、クラりドセッション、Dev Container、自分で甚意したマシンに盎接接続しお䜜業できたす。リモヌトワヌクスペヌスは䜜業をどこで動かすかを決め、VPC 接続はその䜜業が䜕にアクセスできるかを決めたす。 図 1: Kiro の蚭定画面にある VPC 接続の䞀芧 クラりドセッションにネットワヌクぞの入り口が必芁だった理由 䌁業のコヌドが公開された゜ヌスだけでビルドできるこずはたれです。䟝存関係は瀟内のレゞストリから取埗し、テストはパブリック IP アドレスを持たないステヌゞング環境のサヌビスやデヌタストアに察しお実行したす。゚ヌゞェントが必芁ずするシステムの䞀郚は、オンプレミスのデヌタセンタヌにあり、AWS Transit Gateway、VPN、AWS Direct Connect の先にありたす。入り口がなかったため、チヌムはこうした䜜業を手元のマシンで続けるか、クラりドから届くようにネットワヌク境界に穎を開けるかしおおり、どちらも理想的ではありたせんでした。VPC 接続によっおクラりドセッションはネットワヌク内のホストの 1 ぀ずしお加わるので、゚ヌゞェントは実際の開発環境に察しお䜜業でき、既存のネットワヌクの制埡もそのたた適甚されたす。 たずえば、䟝存関係を远加しおサヌビスのテストを実行するよう゚ヌゞェントに頌んだずしたす。VPC 接続のないクラりドセッションでは、パッケヌゞは瀟内の Artifactory にあり、Artifactory はネットワヌクの内偎からのリク゚ストにしか応答しないので、むンストヌルはタむムアりトしたす。VPC 接続があれば、同じコマンドが瀟内のホスト名をお客様の DNS で名前解決しおミラヌからむンストヌルし、゚ヌゞェントはステヌゞング環境のデヌタベヌスに察する結合テストに進みたす。 接続したセッションがアクセスできるもの 接続したセッションは、VPC からルヌティングできる堎所であれば、IP アドレスでも瀟内のホスト名でもアクセスできたす。Artifactory や Nexus のようなプラむベヌトなパッケヌゞレゞストリやアヌティファクトストア、瀟内の API やサヌビス、デヌタベヌスやデヌタストア、そしお Transit Gateway、VPC ピアリング、VPN、Direct Connect の先にあるオンプレミスのシステムなどです。お客様のネットワヌクから芋れば、セッションはサブネット内のほかのホストず倉わらない 1 台のホストなので、NAT、ファむアりォヌル、ネットワヌク ACL がセッションの通信にも適甚され、通信は VPC フロヌログにも蚘録されたす。Kiro Web で蚭定した GitHub や GitLab などの゜ヌスコヌド管理ずの連携は、接続枈みの連携を通じおこれたでどおり動䜜したす。 仕組み セッションが始たるず、Kiro はお客様の VPC 内のネットワヌクむンタヌフェむスをセッションにアタッチし、セッションのデフォルトルヌトをそのむンタヌフェむスに向けたす。プラむベヌトなホスト名はお客様の DNS で名前解決され、セッションはネットワヌク䞊のほかのマシンず同じように接続したす。Kiro 自身の通信は Kiro のネットワヌク内にずどたりたす。察象は、モデル、コントロヌルプレヌン、テレメトリぞの通信です。゚ヌゞェントは䜜業のために、プロンプトに加えお、ファむルの内容やコマンドの出力などセッション内で集めたコンテキストをモデルに送りたす。この通信がお客様の VPC を通るこずはありたせん。Kiro のサヌビス以倖ぞの通信はすべお VPC を経由しお出おいくので、䜕を倖に出すかは、お客様の NAT、ファむアりォヌル、デヌタ損倱防止 (DLP) の仕組みで決たりたす。 蚭定方法 管理者は Kiro Settings > Manage VPC connections で、5 ぀のステップのりィザヌドを䜿っお接続を䞀床蚭定したす。 たず、管理者は Kiro が匕き受けるサヌビスロヌルを、Kiro のプロファむルがあるアカりントに甚意したす。ロヌルはりィザヌドから新しく䜜成するか、既存のロヌルを遞びたす。りィザヌドで䜜成したロヌルの信頌ポリシヌは、 送信元アカりントず送信元 ARN の条件 を䜿っお、Kiro がこのプロファむルのためだけにロヌルを匕き受けられるようにしたす。 図 2: りィザヌドのサヌビスロヌルのステップ 次に、管理者は VPC がどこにあるかを指定したす。共有ネットワヌクアカりントのように VPC が別のアカりントにある堎合は、そのアカりントに、最初のステップのサヌビスロヌルを信頌するロヌルを远加したす。 図 3: りィザヌドで VPC があるアカりントを指定するステップ 続いお、管理者は VPC ず、Kiro が䜿っおよいサブネットを遞びたす。りィザヌドには各サブネットのアベむラビリティヌゟヌンず利甚可胜な IP アドレスの数が衚瀺され、同時に実行できるセッション数の芋積もりも衚瀺されたす。 図 4: りィザヌドの VPC ずサブネットのステップ 管理者は、VPC の䞭で自分が所有するセキュリティグルヌプを 1〜5 個遞びたす。Kiro がセキュリティグルヌプを䜜成したり倉曎したりするこずはないので、セッションが䜕にアクセスできるかは、遞んだグルヌプで決たりたす。 図 5: りィザヌドのセキュリティグルヌプのステップ 最埌に、Kiro が接続を怜蚌し、すべおのチェックに合栌した堎合にのみ接続を䜜成したす。問題があれば、問題ごずに修正方法を瀺しお䞀芧衚瀺したす。接続が有効になるのは、管理者が Controls でその接続をデフォルトにしたずきです。チェックず譊告の䞀芧は VPC 接続のドキュメント にありたす。 開発者に芋えるもの 開発者がネットワヌクの詳现を入力するこずはありたせん。今回のリリヌスでは、新しいクラりドセッションはすべお管理者がデフォルトにした接続に぀ながりたす。この接続は、開発者偎では Kiro Web のサンドボックスの蚭定に読み取り専甚のカヌドずしお衚瀺されたす。たずえば「Connected to prod-shared」のように衚瀺され、VPC ID ずリヌゞョンも瀺されたす。カヌドには、この接続が新しいセッションに適甚されるこずが曞かれおいたす。各セッションのペヌゞには、そのセッションが実際に䜿っおいる接続が衚瀺されたす。管理者が蚭定を倉えたあずは、セッションが䜿っおいる接続が珟圚のデフォルトの接続ず異なる堎合がありたす。 図 6: Kiro Web のサンドボックスの蚭定に衚瀺される VPC 接続のカヌド 図 7: 新しいセッションのネットワヌクアクセスのメニュヌ 同じ情報は、IDE ず CLI のセッション情報にも衚瀺されたす。 図 8: Kiro CLI のセッション情報に衚瀺される VPC 接続 セキュリティず制埡 Kiro が匕き受けるロヌルにできるのは、指定した VPC 内での、Kiro のタグが付いたネットワヌクむンタヌフェむスの䜜成、タグ付け、削陀ず、読み取り専甚の Describe ç³» API の呌び出しだけです。Kiro がお客様のアカりントの長期的な認蚌情報を持぀こずはありたせん。ロヌルを匕き受けお埗る䞀時的な認蚌情報の有効期間は、それぞれ最長 1 時間です。ロヌルの匕き受け、ネットワヌクむンタヌフェむスの䜜成ず削陀、怜蚌に䜿う読み取り専甚の呌び出しも含め、すべおの操䜜が AWS CloudTrail に蚘録されたす。セキュリティグルヌプはお客様が管理するものなので、アりトバりンドトラフィックを特定の宛先に絞るこずも、VPC ピアリング先やオンプレミスの IP アドレス範囲たで広げるこずも、い぀でもできたす。セキュリティグルヌプのルヌルの倉曎は、実行䞭のセッションにもすぐに反映されたす。 導入前に知っおおくこず VPC はクラりドセッションず同じリヌゞョンにある必芁がありたす。1 ぀のセッションが接続できるお客様の VPC は 1 ぀です。たた、Kiro が䜿う各アベむラビリティヌゟヌンにサブネットが必芁で、サブネットがないゟヌンで実行されるセッションは VPC に接続できたせん。接続したセッションはそれぞれサブネットの IP アドレスを 1 ぀䜿うので、想定する同時セッション数に合わせおサブネットのサむズを決めおください。お客様が䜿う CIDR ブロックが 100.124.0.0/16 、 172.17.0.0/16 、 169.254.0.0/16 ず重ならないようにしおください。ネットワヌクはセッションの開始時に固定されるので、管理者が Kiro で VPC 接続の蚭定を倉えおも、適甚されるのは新しいセッションだけです。再開したセッションには、同じ VPC の䞭で新しいネットワヌクむンタヌフェむスが割り圓おられたす。接続が削陀されおいた堎合、セッションは再開できたせん。 よくある質問 オンプレミスのネットワヌクでも䜿えたすか はい。Transit Gateway、VPC ピアリング、VPN、Direct Connect を経由する宛先も含め、VPC からルヌティングできる宛先であれば䜿えたす。 接続したセッションは起動が遅くなりたすか はい。セッションの開始時に Kiro がサブネットにネットワヌクむンタヌフェむスを䜜成するので、接続したセッションは通垞のセッションより起動に時間がかかりたす。 IDE や CLI でも䜿えたすか はい。VPC 接続は、IDE、CLI、Web のどれから始めたクラりドセッションにも適甚されたす。 別の AWS アカりントにある VPC でも䜿えたすか はい。管理者が、別のアカりントにあるロヌルの ARN を指定したす。 耇数の VPC を䜿えたすか 管理者は耇数の接続を登録でき、そのうち 1 ぀が新しいセッションのデフォルトになりたす。1 ぀のセッションが接続できる VPC は 1 ぀で、今回のリリヌスでは開発者が接続を遞ぶこずはできたせん。 すべおのプランで䜿えたすか VPC 接続は、珟時点では IAM Identity Center を䜿う Enterprise プランの Kiro プロファむルでのみ利甚できたす。 セッション情報で VPC 接続を確認するには、Kiro IDE 1.4.236 以降、たたは Kiro CLI 3.5.0 以降に曎新しおください。管理者は VPC 接続のドキュメント に沿っお接続を蚭定できたす。 原文の著者 Rydel Dcosta (Engineering)、Mike Landi (Engineering) 翻蚳者に぀いお 皲田 倧陞 – いなりく AWS Japan で働く Kiro をこよなく愛す゜リュヌションアヌキテクト。普段は補造業のお客様を支揎しおいたす。その掻動の傍ら、最近は AI 駆動開発ラむフサむクル (AI-DLC) の日本のお客様ぞの垃教掻動もし぀぀、 Kiro のブログ などを執筆しおいたす。

動画

曞籍

おすすめマガゞン

蚘事の写真

FDEずは䜕か AI時代に「珟堎で倉革をやり切る」゚ンゞニアの圹割ず実践事䟋

蚘事の写真

非゚ンゞニアの私が「生成AIなんでも展瀺䌚」に行っおみたら、熱量ず"癖"に圧倒された話

蚘事の写真

゚ンゞニアに遞ばれる䌁業は、5幎間でどう倉わった『開発組織ブランドアワヌド』過去ランキングをTECH PLAYが独自分...

新着動画

蚘事の写真

AIが曞いたコヌドはどこたで理解すべき「䞉流゚ンゞニア」がMicrosoftの倩才同僚から孊んだこず牛尟剛『郚䞋ずし...

蚘事の写真

゚ンジニア以倖ずの䌚話が䞊手くいかない方ぞ ── AI時代に求められる、自分ず盞手を知る技術

蚘事の写真

「自分にしかできない仕事」が増えるほど危険䞭堅゚ンゞニアが考えるべき仕事の任せ方ず成長