このリポジトリでは、AWS 上に Cloud9 の代替となる開発環境を構築するための手順と設定ファイルを公開しています。 AWS Cloud9 の代替として、EC2 インスタンスで Visual Studio Code Server を使用します。
Warning
このリポジトリの手順では、デフォルトで t2.micro の EC2 インスタンスを起動します。 このインスタンスを起動し続けると、1 ヶ月で 10 数ドル程度の料金が発生します。
マネジメントコンソール上部の検索欄で「CloudFormation」を検索して開きます。
Note
日本に在住の場合、マネジメントコンソール右上で「東京」リージョンを選択することで、開発環境を快適に使用することができます。
CloudFormation のホーム画面左のメニューから「スタック」を開き、「スタックの作成」を選択します。
cloud9-alternative-cloudformation.yaml をダウンロードして、「スタックの作成」画面でアップロードして次に進みます。
スタック名を適当につけて、その他の設定はデフォルトのままで、作成まで進めます。 (最後に IAM リソースが作成されることを承認するチェックボックスにチェックが必要です)
しばらくすると、スタックの作成が完了します。
Warning
AWS のハンズオンでは、AWS CLI や CDK、Terraform、Serverless Framework などのツールを使用するために、開発環境に非常に強い権限が必要なことが多いです。 そのため、この手順で構築される EC2 インスタンスには AdministratorAccess の権限を付与しています。
マネジメントコンソール上部の検索欄で「Systems Manager」を検索して開きます。
Systems Manager のホーム画面左のメニューから「セッションマネージャー」を開き、「セッションの開始」をクリックします。
「ターゲットインスタンス」で該当の EC2 インスタンスを選択して、「Start session」をクリックすると、ブラウザ上で EC2 インスタンスに接続できます。
セッションマネージャーで接続したら、以下のコマンドを実行して、操作中のユーザーを「ec2-user」に変更します。
sudo su - ec2-userターミナルの表示が以下のようになれば成功です。 (IP アドレスの部分は毎回異なります)
[ec2-user@ip-10-0-0-119 ~]$
Warning
次の Visual Studio Code Server に接続するためのコマンドを実行する前に、上記の手順でユーザーを「ec2-user」に切り替える必要があります。
作成した EC2 インスタンスには、Visual Studio Code がインストール済みです。 以下の手順で、Visual Studio Code Server を起動して接続することができます。
まず、EC2 インスタンスで以下のコマンドを実行して、Visual Studio Code Server を起動します。
code tunnel service install以下のように、メッセージとともにコード (8 桁の英数字) が表示されます。
[2024-08-05 05:40:38] info Using GitHub for authentication, run `code tunnel user login --provider <provider>` option to change this.
To grant access to the server, please log into https://github.com/login/device and use code XXXX-XXXX
ブラウザの別タブで https://github.com/login/device にアクセスし、GitHub にログインして、ターミナル上に表示されたコードを入力してください。
その後、EC2 Instance Connect の画面に戻り、以下のコマンドを実行してください。
code tunnelすると、以下のように表示されます。
*
* Visual Studio Code Server
*
* By using the software, you agree to
* the Visual Studio Code Server License Terms (https://aka.ms/vscode-server-license) and
* the Microsoft Privacy Statement (https://privacy.microsoft.com/en-US/privacystatement).
*
[2024-08-05 05:42:42] info Creating tunnel with the name: XXXXXXXXXXXXXXXXXXXX
[2024-08-05 05:42:42] info
Open this link in your browser https://vscode.dev/tunnel/XXXXXXXXXXXXXXXXXXXX
Connected to an existing tunnel process running on this machine.
Open this link in your browser https://vscode.dev/tunnel/XXXXXXXXXXXXXXXXXXXX
最後の行に表示された URL にアクセスして GitHub でログインすると、ブラウザ上で Visual Studio Code が開きます。
開発環境が t2.micro の EC2 インスタンスで安定的に動作しない場合、インスタンスのスペックが不足している可能性があります。 その場合は、インスタンスタイプを「c7i.large」として構築し直してみてください。
ただし、c7i.large インスタンスを起動し続けると、1 日あたり 2.7 ドル程度、1 ヶ月で 80 ドル程度の料金が発生します。 ハンズオンが終了したら環境を停止または削除するようにしてください。
Note
それでもこの開発環境が安定的に動作しないといった場合は、GitHub の Issue で起票お願いします。
code tunnel service install コマンドを実行して GitHub でログインした後、以下のエラーメッセージが表示される場合があります。
[2024-12-01 03:01:20] error Error creating dbus session. This command uses systemd for managing services, you should check that systemd is installed and under your user.If running
systemctl statusworks, systemd is ok, but your session dbus may not be. You might need to:
- Install the
dbus-user-sessionpackage, and reboot if it was not installed- Start the user dbus session with
systemctl --user enable dbus --now.The error encountered was: I/O error: No such file or directory (os error 2)
このメッセージが表示されても次の code tunnel コマンドは正常に動作するようなので、code tunnel コマンドを試してみてください。
code コマンド実行時に -bash: code: command not found というエラーになった場合、以下のコマンドを順に実行することで、code コマンドをインストールし直すことができます。
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/yum.repos.d/vscode.repo > /dev/null
dnf check-update
sudo dnf install -y codeEC2 インスタンスには、起動時のスクリプト (ユーザーデータ) で Visual Studio Code をインストールしています。
code コマンドが見つからない場合、以下のコマンドでユーザーデータのログを確認してください。
cat /var/log/cloud-init-output.logcode コマンドはインストールされているものの、ブラウザから Visual Studio Code に接続できない場合、以下のコマンドで Visual Studio Code Server の起動状況を確認してください。
code tunnel service log構築した開発環境を使わないときは、「EC2 インスタンスの停止」または「CloudFormation スタックの削除」により、料金を削減することができます。
マネジメントコンソール上部の検索欄で「EC2」を検索して開きます。
EC2 のホーム画面左のメニューから「インスタンス」を開き、EC2 インスタンスを選択して、「インスタンスの状態」から「インスタンスの停止」を実行します。
Warning
EC2 インスタンスを停止しても、データを保存するストレージ (EBS) は確保したままのため、ストレージの料金は発生し続けます。 完全に料金が発生しないようにするには、次の手順で「削除」を実施する必要があります。
マネジメントコンソール上部の検索欄で「CloudFormation」を検索して開きます。
CloudFormation のホーム画面左のメニューから「スタック」を開き、スタックを選択して、「削除」を実行します。
画面左のメニューボタン (≡) をクリックし、「ターミナル」>「新しいターミナル」でターミナルを開くことができます。
作業用のディレクトリは、ターミナルで mkdir workspace のようなコマンドで作成してください。
画面左のメニューボタン (≡) をクリックし、「ファイル」>「フォルダーを開く」で作成したディレクトリを開くことができます。
ローカルからファイルをアップロードする際は、エクスプローラー (画面左のファイルのアイコン) を開いて、エクスプローラーを右クリックして「アップロード」を選択してください。
または、エクスプローラーにドラッグ & ドロップすることでもファイルをアップロードできます。
ターミナル上で Web アプリケーション等を起動した場合、ターミナルの右の「ポート」のタブを開いて、「転送されたアドレス」を右クリックし、「ブラウザーで開く」をクリックすると開くことができます。または、画面右下に表示される「ブラウザーで開く」をクリックしてください。
以下のコマンドで Git をインストールできます。
sudo dnf install -y git以下のコマンドで、インストールできたことを確認してください。
git -vNode.js や Terraform などの特定バージョンをインストールしたい際は、asdf を使用すると便利です。
以下の公式ドキュメントに従って、「1. 依存関係のインストール」「2. asdf のダウンロード」「3. asdf のインストール」の手順でインストールしてください。
https://asdf-vm.com/ja-jp/guide/getting-started.html
なお、「1. 依存関係のインストール」ではパッケージマネージャが DNF の場合の手順を実施してください。 また、「3. asdf のインストール」では、「Bash & Git」の手順を実施してください。
「3. asdf のインストール」で ~/.bashrc を編集したら、ターミナルを一度閉じて開き直してください。
以下のコマンドで、インストールできたことを確認してください。
asdf versionasdf を使って Node.js をインストールする手順を以下に示します。
まず、以下のコマンドで Node.js のインストールに必要な OS のパッケージをインストールします。
sudo dnf install -y python3 gcc-c++ make python3-pip参考: https://github.com/nodejs/node/blob/main/BUILDING.md#building-nodejs-on-supported-platforms
続いて、以下のコマンドで asdf の Node.js プラグインをインストールします。
asdf plugin add nodejs作業用のディレクトリに .tool-versions というファイルを作成し、インストールしたい Node.js のバージョンを以下のように記述します。
nodejs 20.16.0
.tool-versions を配置したディレクトリで以下のコマンドを実行して、Node.js をインストールします。
asdf install以下のコマンドで、インストールできたことを確認してください。
node -v
asdf を使って Terraform をインストールする手順を以下に示します。
まず、以下のコマンドで Terraform のインストールに必要な OS のパッケージをインストールします。
sudo dnf -y install gnupg2 --allowerasing続いて、以下のコマンドで asdf の Terraform プラグインをインストールします。
asdf plugin add terraform作業用のディレクトリに .tool-versions というファイルを作成し、インストールしたい Terraform のバージョンを以下のように記述します。
terraform 1.3.8
.tool-versions を配置したディレクトリで以下のコマンドを実行して、Terraform をインストールします。
asdf install以下のコマンドで、インストールできたことを確認してください。
terraform -v以下のコマンドで、Docker をインストールします。
sudo dnf update
sudo dnf install -y docker以下のコマンドで Docker を起動します。
sudo systemctl start docker以下のコマンドで Docker コンテナの一覧を表示できます。
sudo docker container ls以下のようにエラーなく一覧が表示されれば、Docker のセットアップは完了です。
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
Warning
docker コマンドを sudo をつけずに実行できるようにしたい場合は、
sudo usermod -a -G docker "$(whoami)" コマンドを実行したうえで、
ターミナルを一度閉じて開き直してください。
EC2 インスタンスで Visual Studio Code Server を使用する環境の構築は、「AWS CDK Conference Japan 2024 presented by JAWS-UG コントリビュートワークショップ」のリポジトリを参考にさせていただきました。