このワークショップでは GitHub Codespaces を使って進めます。起動に数分かかるので、最初に立ち上げておきましょう。
GitHub Codespaces とは: ブラウザの中で使える開発環境です。VS Code と同じ画面で、ファイルの編集やターミナルでのコマンド実行ができます。自分のパソコンに何もインストールしなくても、ワークショップに必要なツールがそろった環境がすぐに使えます。
以下のリンクを開きます。
https://github.com/jaws-ug-cdk/cdkd-intro-workshop
画面右上の Fork ボタンを押します。Create a new fork の画面が開いたら、設定は変えずに Create fork ボタンを押します。
https://github.com/<GitHub のユーザー名>/cdkd-intro-workshop という、自分のアカウントのリポジトリが作られます。
fork とは: ほかの人のリポジトリを、自分の GitHub アカウントにまるごとコピーすることです。fork したリポジトリは自分のものなので、ワークショップ中に書き換えたコードを自由にコミットして残しておけます。元のリポジトリには影響しません。
fork した自分のリポジトリのページで、Code ボタンから Codespaces タブを開き、Create codespace on main ボタンを押します。
元のリポジトリ(jaws-ug-cdk/cdkd-intro-workshop)のページから Codespace を作らないように注意してください。画面左上のリポジトリ名が、自分の GitHub のユーザー名になっていることを確かめましょう。
画面が切り替わり、Codespace の作成が始まります。起動を待っている間に、次のページを読み進めてください。
画面下部に TERMINAL パネルが表示され、ターミナルに次のようなプロンプトが出たら起動完了です。
@<GitHub のユーザー名> ➜ /workspaces/cdkd-intro-workshop (main) $
以降の手順では、このターミナルにコマンドを入力していきます。
起動のときに、ワークショップで使う Node.js と AWS CLI のインストール、CDK のコードが使うパッケージのインストール(npm ci)まで自動で行われます。
GitHub Codespaces の利用料について: 個人の GitHub アカウントには、毎月の無料枠(Free プランで 120 コア時間、ストレージ 15 GB)があります。このワークショップで使う範囲は無料枠に収まりますが、Codespace は残っている間ストレージを消費し続けます。ワークショップが終わったら、後片付け の手順で Codespace を削除してください。
コマンドが動かなくなった場合は、トラブルシューティング を確認してください。