前提条件ステップ 1: 環境を作成するステップ 2: ベーシック演習ステップ 3: クリーンアップする関連情報

AWS Cloud9の開始方法

このチュートリアルを使用して、の使用を開始します AWS Cloud9。コンソールまたは AWS Command Line Interface （AWS CLI）を使用して IDE AWS Cloud9 を使用できます AWS Cloud9 。このチュートリアルでは、 AWS Cloud9 開発環境をセットアップし、IDE AWS Cloud9 を使用して最初のアプリケーションをコーディング、実行、デバッグする方法について説明します。詳細については AWS Cloud9、「とは AWS Cloud9」を参照してください。

AWS Cloud9 IDE の詳細については、「」を参照してくださいIDE AWS Cloud9 のツアー。

チュートリアルの所要時間は約 1 時間です。

警告

このチュートリアルを完了すると、 AWS アカウントに料金が発生する可能性があります。これには、Amazon EC2 の使用に伴う料金が含まれる場合があります。詳細については、「Amazon EC2 の料金」を参照してください。

前提条件

このチュートリアルを正常に完了するには、まず「セットアップ AWS Cloud9」のステップを完了する必要があります。

ステップ 1: 環境を作成する

このステップでは、 AWS Cloud9 コンソールまたは AWS CLI を使用して AWS Cloud9 開発環境を作成できます。

注記

このチュートリアルで使用する環境を作成済みである場合は、その環境を開き、「ステップ 2: IDE のベーシック演習」に進んでください。

AWS Cloud9では、開発環境または環境は、開発プロジェクトのファイルを保存し、アプリケーションを開発するためのツールを実行する場所です。このチュートリアルでは、EC2 環境を作成し、この環境でファイルとツールを操作します。

Create an EC2 Environment with the console

AWS Cloud9 コンソールにサインインします。
- ご自身が AWS アカウントを使用する唯一のユーザーである場合、または単一の AWS アカウントの IAM ユーザーである場合は、https://console.aws.amazon.com/cloud9/ に移動します。
- 組織でを使用している場合は AWS IAM Identity Center、 AWS アカウント管理者にサインイン手順を依頼してください。
- 教室内の学生である場合は、インストラクターにサインインの手順をお問い合わせください。
AWS Cloud9 コンソールにサインインしたら、上部のナビゲーションバーで AWS リージョンを選択して環境を作成します。利用可能なのリストについては AWS リージョン、 AWS Cloud9 の「」を参照してくださいAWS 全般のリファレンス。
表示されている場所の１つで、大きな［環境を作成する］ボタンを選択します。

まだ AWS Cloud9 環境がない場合は、ウェルカムページにボタンが表示されます。

環境がすでにある場合 AWS Cloud9 、ボタンは次のように表示されます。
[Create environment] (環境の作成) ページで、[Name] (名前) に環境の名前を入力します。
［Description (説明)］に、環境に関する説明を入力します。このチュートリアルでは、This environment is for the AWS Cloud9 tutorial. を使用します。
[Environment type] (環境タイプ) で、[New EC2 instance] (新しい EC2 インスタンス) を選択して Amazon EC2 環境を作成します。
- [New EC2 instance] (新しい EC2 インスタンス) — AWS Cloud9 から SSH 経由で直接接続できる新しい Amazon EC2 インスタンスを起動します。新しい Amazon EC2 インスタンスは、Systems Manager を使用して操作できます。詳細については、「を使用した no-ingress EC2 インスタンスへのアクセス AWS Systems Manager」を参照してください。
- [Existing compute] (既存のコンピューティング) — SSH ログインの詳細を必要とする既存の Amazon EC2 インスタンスを起動します。Amazon EC2 インスタンスにはインバウンドセキュリティグループルールが必要です。
  - [Existing compute] (既存のコンピューティング) オプションを選択すると、サービスロールが自動的に作成されます。サービスロールの名前は、セットアップ画面の下部にある注記で確認できます。
注記
自動シャットダウンは、既存のコンピューティングを使用する Amazon EC2 インスタンスを使用して作成された AWS Cloud9 環境では利用できません。

警告
環境の Amazon EC2 インスタンスを作成すると、Amazon EC2 の AWS アカウントに対する課金が発生する場合があります。Systems Manager を使用して EC2 インスタンスへの接続を管理する場合、追加コストはかかりません。
[Instance type] (インスタンスタイプ) の [New EC2 instance] (新しい EC2 インスタンス) パネルでは、デフォルトの選択のままにします。このオプションでは、RAM と vCPU が少ない可能性があります。ただし、このチュートリアルでは、このメモリ量で十分です。

警告
より多くの RAM と vCPUsを持つインスタンスタイプを選択すると、Amazon EC2 AWS アカウントのに追加料金が発生する可能性があります。
プラットフォームで、必要な Amazon EC2 インスタンスのタイプを選択します。Amazon Linux 2023、Amazon Linux 2、または Ubuntu 22.04 LTS。はインスタンス AWS Cloud9 を作成し、環境をそのインスタンスに接続します。

重要
EC2 環境には、[Amazon Linux 2023] オプションを選択することをお勧めします。Amazon Linux 2023 AMI は、安全で安定した、高パフォーマンスのランタイム環境を提供します。さらに、2024 年までの長期サポートも含まれています。
詳細については、AL2023 のページを参照してください。
[Timeout] (タイムアウト) の期間を選択します。このオプションは、自動休止状態になるまでの AWS Cloud9 の非アクティブ時間を決定します。環境の IDE に接続されているすべてのウェブブラウザインスタンスが閉じられると、は指定された時間を AWS Cloud9 待ってから、環境の Amazon EC2 インスタンスをシャットダウンします。

警告
期間を長くするほど、 AWS アカウントに対する課金が増える可能性があります。
[Network settings] (ネットワーク設定) パネルで、環境にアクセスする方法を、次の 2 つのオプションから選択します。
- AWS System Manager (SSM) – このメソッドは、インバウンドポートを開かずに SSM を使用して環境にアクセスします。
- Secure Shell (SSH) — この方法では、SSH を使用して環境にアクセスします。受信ポートを開く必要があります。
VPC 設定を選択すると、環境の Amazon Virtual Private Cloud とサブネットが表示されます。は Amazon Virtual Private Cloud (Amazon VPC) AWS Cloud9 を使用して、新しく作成された Amazon EC2 インスタンスと通信します。このチュートリアルでは、事前に選択されたデフォルト設定を変更しないことをお勧めします。デフォルト設定では、 AWS Cloud9 は、新しい環境と同じ AWS アカウントおよびリージョンの単一のサブネットでデフォルトの VPC を自動的に使用しようとします。

Amazon VPC 選択肢の詳細については、「コンソールを使用した EC2 環境の作成」および「AWS Cloud9 開発環境の VPC 設定」を参照してください。
最大 50 個のタグを追加します。タグごとにキーと値を指定します。これを行うには、[Add new tag] (新しいタグを追加) を選択します。タグはリソースタグとして AWS Cloud9 環境にアタッチされ、 AWS CloudFormation スタック、Amazon EC2 インスタンス、Amazon EC2 セキュリティグループなどの基盤となるリソースに伝達されます。タグの詳細については、「IAM ユーザーガイド」のAWS 「リソースタグを使用したアクセスの制御」およびこのガイドの「詳細情報」を参照してください。

警告
これらのタグを作成後に更新した場合、変更は基になるリソースには反映されません。詳細については、タグに関する詳細情報の「基礎となるリソースへのタグ更新の伝播」を参照してください。
[Create] (作成) を選択して環境を作成すると、ホームページにリダイレクトされます。アカウントが正常に作成されると、 AWS Cloud9 コンソールの上部に緑色のフラッシュバーが表示されます。新しい環境を選択し、[Open in Cloud9] (Cloud9 で開く) を選択して IDE を起動できます。

アカウントの作成に失敗すると、 AWS Cloud9 コンソールの上部に赤いフラッシュバーが表示されます。アカウントの作成に失敗する原因としては、ウェブブラウザ、 AWS アクセス許可、インスタンス、または関連するネットワークの問題が考えられます。可能な解決方法は、「AWS Cloud9 のトラブルシューティング」セクションで参照できます。

注記
AWS Cloud9 はIMDSv1 と IMDSv2 の両方をサポートしています。IMDSv1 よりもセキュリティレベルが強化されているため、IMDSv2 の導入をお勧めします。IMDSv2 の利点の詳細については、「AWS セキュリティブログ」を参照してください。IMDSv1 から IMDSv2 への移行の詳細については、「Linux インスタンス用 Amazon EC2 ユーザーガイド」の「インスタンスメタデータサービスバージョン 2 の使用への移行」を参照してください。

注記
環境がプロキシを使用してインターネットにアクセスしている場合は、依存関係をインストール AWS Cloud9 できるように、プロキシの詳細をに提供する必要があります。詳細については、「依存関係をインストールできませんでした」を参照してください。

Create an EC2 environment with the AWS CLI

まだインストールしていない場合は AWS CLI、をインストールして設定します。これを行うには、AWS Command Line Interface ユーザーガイドで以下の項目を参照してください。
- AWS コマンドラインインターフェイスのインストール
- クイック設定
次のいずれかの認証情報 AWS CLI を使用してを設定できます。
- のチームのセットアップ AWS Cloud9 で作成した IAM ユーザー。
- AWS アカウント全体の複数のユーザーの AWS Cloud9 リソースを定期的に操作する場合、アカウントの IAM 管理者。を IAM 管理者 AWS CLI として設定できない場合は、アカウント管理者に AWS 確認してください。詳細については、IAM ユーザーガイドの「最初の IAM 管理者ユーザーおよびグループの作成」を参照してください。
- AWS アカウントのルートユーザー。ただし、常に自分の AWS アカウントを使用する唯一のユーザーであり、他のユーザーと環境を共有する必要はありません。このオプションは AWS セキュリティのベストプラクティスではないため、お勧めしません。詳細については、「Amazon Web Services 全般のリファレンス」の「AWS アカウントのアクセスキーの作成、無効化、削除」を参照してください。
- その他のオプションについては、 AWS アカウント管理者またはクラスルームインストラクターにお問い合わせください。
次の AWS Cloud9 コマンドで、 --regionとの値を指定します--subnet-id。次に、そのコマンドを実行し、「"environmentId"」値を記録します。この値は、後でクリーンアップに必要になります。
```
aws cloud9 create-environment-ec2 --name my-demo-environment --description "This environment is for the AWS Cloud9 tutorial." --instance-type t2.micro --image-id resolve:ssm:/aws/service/cloud9/amis/amazonlinux-2-x86_64 --region MY-REGION --connection-type CONNECT_SSM --subnet-id subnet-12a3456b
```
上記のコマンドでは:
- --name は、環境の名前を表します。このチュートリアルでは、my-demo-environment という名前を使用します。
- --description は、環境の説明 (オプション) を表します。
- --instance-type は、 AWS Cloud9 で起動して新しい環境に接続する Amazon EC2 インスタンスのタイプを表します。この例では t2.micro を指定します。これは比較的小さい RAM および vCPU を使用しますが、このチュートリアルでは十分です。より多くの RAM と vCPUs でインスタンスタイプを指定すると、Amazon EC2 の AWS アカウントに追加料金が発生する可能性があります。使用可能なインスタンスタイプのリストについては、 AWS Cloud9 コンソールの環境作成ウィザードを参照してください。
- EC2 インスタンスの作成に使用される Amazon マシンイメージ (AMI) の識別子を--image-id は指定します。インスタンスの AMI を選択するには、有効な AMI エイリアスまたは有効な AWS Systems Manager (SSM) パスを指定する必要があります。上記の例では、Amazon Linux 2 AMI の SSM パスが指定されています。
  
  詳細については、AWS CLI コマンドリファレンスの「create-environment-ec2」を参照してください。
- --region は、環境を作成する AWS Cloud9 の AWS リージョンの ID を表します。使用可能な AWS リージョンのリストについては、 AWS Cloud9の「」を参照してくださいAmazon Web Services 全般のリファレンス。
- --connection-type CONNECT_SSM は、Systems Manager を介して Amazon EC2 インスタンス AWS Cloud9 に接続するを指定します。このオプションにより、インスタンスへのインバウンドトラフィックが許可されなくなります。詳細については、「を使用した no-ingress EC2 インスタンスへのアクセス AWS Systems Manager」を参照してください。
  
  注記
  このオプションを使用するときは、AWSCloud9SSMAccessRole サービスロールと AWSCloud9SSMInstanceProfile を作成する必要があります (まだ作成されていない場合)。詳細については、「を使用した Systems Manager のインスタンスプロファイルの管理 AWS CLI」を参照してください。
- --subnet-id は、 AWS Cloud9 使用するサブネットを表します。subnet-12a3456b は Amazon Virtual Private Cloud (VPC) のサブネットの ID に置き換えます。これは AWS Cloud9と互換性がある必要があります。詳細については、「AWS Cloud9 開発環境の VPC 設定」の VPC と他の VPC リソースを作成するを参照してください。
- AWS Cloud9 は、環境の IDE に接続されているすべてのウェブブラウザインスタンスが閉じられた後、環境の Amazon EC2 インスタンスをシャットダウンします。この期間を設定するには、--automatic-stop-time-minutes と分数を追加します。期間が短いと、 AWS アカウントへの請求額が減る可能性があります。同様に、期間が長いと課金が高くなる可能性があります。
- デフォルトでは、このコマンドを呼び出すエンティティが環境を所有します。これを変更するには、--owner-id と、所有エンティティの Amazon リソースネーム (ARN) を追加します。
このコマンドを正常に実行したら、新しく作成した環境の AWS Cloud9 IDE を開きます。これを行うには、「で環境を開く AWS Cloud9」を参照してください。次に、このトピックに戻り、ステップ 2: IDE のベーシック演習に進み、IDE AWS Cloud9 を使用して新しい環境を操作する方法を学びます。

環境を開こうとしても、5 分以上経っても IDE が表示され AWS Cloud9 ない場合は、ウェブブラウザ、 AWS アクセス許可、インスタンス、または関連する VPC に問題がある可能性があります。可能な修正については、「環境を開くことができない」を参照してください。

ステップ 2: IDE のベーシック演習

このチュートリアルでは、IDE AWS Cloud9 を使用してアプリケーションを作成およびテストする方法をいくつか紹介します。

［editor (エディタ)］ウィンドウを使用して、コードを作成および編集できます。
［terminal (ターミナル)］ウィンドウまたは［Run Configuration (実行設定)］ウィンドウを使用して、デバッグせずにコードを実行できます。
［Debugger (デバッガー)］ウィンドウを使用してコードをデバッグできます。

JavaScript および Node.js エンジンを使用して、これらの 3 つのタスクを実行します。他のプログラミング言語を使用する手順については、「のチュートリアル AWS Cloud9」を参照してください。

環境の準備をする

JavaScript コードの実行とデバッグに必要なツールのほとんどはインストール済みです。ただし、このチュートリアルではもう 1 つの Node.js パッケージが必要です。これを次のようにインストールします。

AWS Cloud9 IDE の上部にあるメニューバーで、ウィンドウ、新しいターミナルを選択するか、既存のターミナルウィンドウを使用します。
ターミナルウィンドウ (IDE の下部にあるタブの 1 つ) では、以下のように入力します。
```
npm install readline-sync
```
結果が以下のようになることを確認します。npm WARN メッセージが表示されても、無視してかまいません。
```
+ readline-sync@1.4.10
added 1 package from 1 contributor and audited 5 packages in 0.565s
found 0 vulnerabilities
```

コードを記述する

コードを記述することから始めます。

メニューバーで［File (ファイル)］、［New File (新規ファイル)］の順に選択します。

以下の JavaScript を新しいファイルに追加します。


var readline = require('readline-sync');
var i = 10;
var input;

console.log("Hello Cloud9!");
console.log("i is " + i);

do {
    input = readline.question("Enter a number (or 'q' to quit): ");
    if (input === 'q') {
        console.log('OK, exiting.')
    }
    else{
        i += Number(input);
        console.log("i is now " + i);
    }
} while (input != 'q');

console.log("Goodbye!");

［File (ファイル)］、［Save (保存)］の順に選択し、ファイルを hello-cloud9.js として保存します。

コードを実行する

次に、コードを実行できます。

使用しているプログラミング言語によっては、複数の方法でコードを実行できる場合があります。このチュートリアルで使用している JavaScript は、ターミナルウィンドウまたは［Run Configuration (実行設定)］ウィンドウを使用して実行できます。

［Run Configuration (実行設定)］ウィンドウを使用してコードを実行するには

メニューバーで、［Run (実行)］、［Run Configurations (実行設定)］、［New Run Configuration (新しい実行設定)］の順に選択します。
新しい［設定の実行］ウィンドウ (IDE の下部にあるタブの 1 つ) で、［コマンド］フィールドに「hello-cloud9.js」と入力し、［実行］を選択します。
[Run Configuration] (実行設定) プロンプトがアクティブであることを確認してから、プロンプトで番号を入力してアプリケーションを操作します。
［Run Configuration (実行設定)］ウィンドウにコードの出力が表示されます。次のように表示されます。

ターミナルウィンドウを使用してコードを実行するには

先ほど使用したターミナルウィンドウに移動します (または新しいターミナルウィンドウを開きます)。
ターミナルウィンドウのプロンプトで「ls」と入力し、コードファイルがファイルのリストにあることを確認します。
プロンプトで「node hello-cloud9.js」と入力して、アプリケーションを起動します。
プロンプトで番号を入力して、アプリケーションを操作します。
ターミナルウィンドウにコードの出力が表示されます。次のように表示されます。

コードをデバッグする

最後に、［Debugger (デバッガー)］ウィンドウを使用してコードをデバッグできます。

行 10 の横のマージンを選択して、行 10 のコード (if (input === 'q')) にブレークポイントを追加します。以下のように、その行番号の横に赤い円が表示されます。
IDE の右側で [Debugger] ボタンを選択して、Debugger ウィンドウを開きます。または、メニューバーで [Window (ウィンドウ)]、[Debugger (デバッガー)] の順に選択します。

次に、[Debugger] (デバッガー) ウィンドウの [Watch Expressions] (ウォッチ式) セクションで [Type an expression here] (ここに式を入力) を選択して、input 変数を監視します。
コードを実行するために先ほど使用した［Run Configuration (実行設定)］ウィンドウに移動します。［Run(実行) ］を選択します。

または、新しい [Run Configuration] (実行設定) ウィンドウを開いて、コードの実行を開始することもできます。そのためには、メニューバーから [Run] (実行)、[Run with] (環境を指定して実行)、[Node.js] の順に選択します。
［Run Configuration (実行設定)］プロンプトで番号を入力し、コードが行 10 で一時停止することを確認します。[Debugger] (デバッガー) ウィンドウに、[Watch Expressions] (ウォッチ式) に入力した値が表示されます。
[Debugger] (デバッガー) ウィンドウで、[Resume] (再開) を選択します。これは、前のスクリーンショットで強調表示されている青い矢印アイコンです。
[設定の実行] ウィンドウで [停止] を選択し、デバッガーを停止します。

ステップ 3: クリーンアップする

このチュートリアル AWS アカウントに関連するへの継続的な料金を回避するには、環境を削除します。

警告

削除した環境を復元することはできません。

Delete the Environment by using the AWS Cloud9 console

ダッシュボードを開くには、IDE のメニューバーで、［AWS Cloud9］、［Go To Your Dashboard (ダッシュボードを開く)］を選択します。
次のいずれかを行います：
- ［my-demo-environment］カード内のタイトルを選択し、もう一度［Delete (削除)］を選択します。
- ［my-demo-environment］を選択し、次に［Delete (削除)］を選択します。
［Delete (削除)］ダイアログボックスに「Delete」と入力し、［Delete (削除)］を選択します。削除オペレーションには数分かかります。

注記

このチュートリアルに厳密に従っていれば、環境は EC2 環境であり、 AWS Cloud9 は、その環境に接続されていた Amazon EC2 インスタンスも終了します。

ただし、チュートリアルに従う代わりに SSH 環境を使用し、その環境が Amazon EC2 AWS Cloud9 インスタンスに接続されている場合、そのインスタンスを終了しないでください。後でそのインスタンスを終了しない場合、そのインスタンスに関連する Amazon EC2 の料金が引き続き発生する AWS アカウント可能性があります。

Delete the Environment with the AWS CLI

コマンドを実行し AWS Cloud9 delete-environment、削除する環境の ID を指定します。
```
aws cloud9 delete-environment --region MY-REGION --environment-id 12a34567b8cd9012345ef67abcd890e1
```
前述のコマンドで、を環境が作成された AWS リージョンMY-REGIONに、を削除する環境の ID 12a34567b8cd9012345ef67abcd890e1 に置き換えます。

環境の作成時に ID を保存しなかった場合は、 AWS Cloud9 コンソールを使用して ID を見つけることができます。コンソールで環境の名前を選択し、［Environment ARN (環境 ARN)］の最後の部分を見つけます。
このチュートリアル用に Amazon VPC を作成し、不要になった場合は、Amazon VPC コンソールを使用して VPC を削除します (https://console.aws.amazon.com/vpc)。

タスク	次のトピックを参照
環境で何ができるかに関する詳細はこちら。	での環境の使用 AWS Cloud9
他のコンピュータ言語を試します。	のチュートリアル AWS Cloud9
IDE AWS Cloud9 の詳細について説明します。	IDE を操作するの IDE AWS Cloud9 のツアー
テキストチャットサポートにより、リアルタイムで新しい環境を使用するように他のユーザーを招待します。	での共有環境の使用 AWS Cloud9
SSH 環境の作成これらの環境では、 AWS Cloud9 がユーザーに代わって作成した Amazon EC2 インスタンスではなく、ユーザーが作成したクラウドコンピューティングインスタンスまたはサーバーを使用します。	での環境の作成 AWS Cloud9 および SSH 環境ホスト要件
AWS Toolkit を使用して、 AWS Lambda 関数とサーバーレスアプリケーションでコードを作成、実行、デバッグします。	Toolkit を使用した AWS Lambda 関数の操作 AWS
AWS Cloud9 でを使用しますAmazon Lightsail。	AWS Cloud9 IDE での Amazon Lightsail インスタンスの操作
AWS Cloud9 でを使用します AWS CodePipeline。	IDE AWS CodePipeline での AWS Cloud9 の使用
AWS Cloud9 AWS CLIは、 AWS CloudShell、、 AWS クラウド開発キット (AWS CDK) AWS CodeCommit、GitHub、Amazon DynamoDB、Node.js、Python、またはその他のプログラミング言語で使用します。	のチュートリアル AWS Cloud9
AWS RoboMaker でインテリジェントなロボット工学アプリケーションのコードを使用します。	AWS RoboMaker デベロッパーガイド内にある AWS Cloud9を使って開発