AWS Cloud9 の開始方法 - AWS Cloud9

新規のお客様への AWS Cloud9 の提供は終了しました。AWS Cloud9 の既存のお客様は、通常どおりサービスを引き続き使用できます。詳細はこちら

AWS Cloud9 の開始方法

このチュートリアルにより、AWS Cloud9 の使用を開始できます。AWS Cloud9 コンソールまたは AWS Command Line Interface (AWS CLI) を使用して IDE AWS Cloud9 を使用できます。このチュートリアルでは、AWS Cloud9 開発環境を設定してから、AWS Cloud9 IDE を使用して最初のアプリケーションのコード記述、実行、デバッグを行う方法を説明します。AWS Cloud9の詳細については、とはAWS Cloud9を参照してください。

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

チュートリアルの所要時間は約 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
  1. AWS Cloud9 コンソールにサインインします。

    • AWS アカウントの使用者が自分だけであるか、単一の AWS アカウントの IAM ユーザーである場合は、https://console.aws.amazon.com/cloud9/ にアクセスします。

    • 組織で AWS IAM Identity Center を使用している場合は、AWS アカウント管理者にサインインの手順をお問い合わせください。

    • 教室内の学生である場合は、インストラクターにサインインの手順をお問い合わせください。

  2. AWS Cloud9 コンソールにサインインしたら、上部のナビゲーションバーで、環境を作成する先の AWS リージョンを選択します。利用可能な AWS リージョンのリストについては、「AWS 全般のリファレンス」の「AWS Cloud9」を参照してください。

    AWS Cloud9 コンソールの AWS リージョンセレクター
  3. 表示されている場所の1つで、大きな[環境を作成する]ボタンを選択します。

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

    AWS Cloud9 コンソールのウェルカムページ

    AWS Cloud9 環境がすでにある場合、このボタンは以下のように表示されます。

    AWS Cloud9 コンソールの環境作成ボタン
  4. [Create environment] (環境の作成) ページで、[Name] (名前) に環境の名前を入力します。

  5. Description (説明)]に、環境に関する説明を入力します。このチュートリアルでは、This environment is for the AWS Cloud9 tutorial. を使用します。

  6. [Environment type] (環境タイプ) で、[New EC2 instance] (新しい EC2 インスタンス) を選択して Amazon EC2 環境を作成します。

    • [Existing compute] (既存のコンピューティング) — SSH ログインの詳細を必要とする既存の Amazon EC2 インスタンスを起動します。Amazon EC2 インスタンスにはインバウンドセキュリティグループルールが必要です。

      • [Existing compute] (既存のコンピューティング) オプションを選択すると、サービスロールが自動的に作成されます。サービスロールの名前は、セットアップ画面の下部にある注記で確認できます。

    注記

    既存のコンピューティングを使用して、Amazon EC2 インスタンスを使って作成された AWS Cloud9 環境では、自動シャットダウンは使用できません。

    警告

    環境の Amazon EC2 インスタンスを作成すると、Amazon EC2 の AWS アカウント に対する課金が発生する場合があります。Systems Manager を使用して EC2 インスタンスへの接続を管理する場合、追加コストはかかりません。

  7. [Instance type] (インスタンスタイプ) の [New EC2 instance] (新しい EC2 インスタンス) パネルでは、デフォルトの選択のままにします。このオプションでは、RAM と vCPU が少ない可能性があります。ただし、このチュートリアルでは、このメモリ量で十分です。

    警告

    サイズのより大きい RAM および vCPU を備えたインスタンスタイプを選択すると、Amazon EC2 に対する追加料金が AWS アカウントで発生する場合があります。

  8. [プラットフォーム] で、[Amazon Linux 2023][Amazon Linux 2]、または [Ubuntu 22.04 LTS] のうち、必要な Amazon EC2 インスタンスのタイプを選択します。AWS Cloud9 はインスタンスを作成し、環境を接続します。

    重要

    EC2 環境には、[Amazon Linux 2023] オプションを選択することをお勧めします。Amazon Linux 2023 AMI は、安全で安定した、高パフォーマンスのランタイム環境を提供します。さらに、2024 年までの長期サポートも含まれています。

    詳細については、AL2023 のページを参照してください。

  9. [Timeout] (タイムアウト) の期間を選択します。このオプションは、自動休止状態になるまでの AWS Cloud9 の非アクティブ時間を決定します。環境の IDE に接続されているウェブブラウザインスタンスが閉じられると、AWS Cloud9 はこの指定時間待機してから、環境の Amazon EC2 インスタンスをシャットダウンします。

    警告

    期間を長くするほど、AWS アカウントに対する課金が増える可能性があります。

  10. [Network settings] (ネットワーク設定) パネルで、環境にアクセスする方法を、次の 2 つのオプションから選択します。

    • AWS System Manager (SSM) — この方法では、受信ポートを開かずに SSM を使用して環境にアクセスします。

    • Secure Shell (SSH) — この方法では、SSH を使用して環境にアクセスします。受信ポートを開く必要があります。

  11. [VPC Settings] (VPC 設定) を選択し、環境の Amazon Virtual Private Cloud およびサブネットを表示します。AWS Cloud9 は Amazon Virtual Private Cloud (Amazon VPC) を使用して、新しく作成した Amazon EC2 インスタンスと通信します。このチュートリアルでは、事前に選択されたデフォルト設定を変更しないことをお勧めします。デフォルト設定の場合、AWS Cloud9 は、新しい環境と同じ AWS アカウントおよびリージョンで 1 つのサブネットを持つデフォルト VPC を自動的に使用しようとします。

    Amazon VPC 選択肢の詳細については、「コンソールを使用した EC2 環境の作成」および「AWS Cloud9 開発環境の VPC 設定」を参照してください。

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

    警告

    これらのタグを作成後に更新した場合、変更は基になるリソースには反映されません。詳細については、タグに関する詳細情報の「基礎となるリソースへのタグ更新の伝播」を参照してください。

  13. [Create] (作成) を選択して環境を作成すると、ホームページにリダイレクトされます。アカウントが正常に作成されると、AWS Cloud9 コンソールの上部に緑色の点滅バーが表示されます。新しい環境を選択し、[Open in Cloud9] (Cloud9 で開く) を選択して IDE を起動できます。

    AWS Cloud9 コンソールの AWS 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
  1. まだ AWS CLI をインストールして設定していない場合は、インストールして設定します。これを行うには、次の「AWS Command Line Interface ユーザーガイド」の手順を参照してください。

    次のいずれかの認証情報を使用して AWS CLI を設定できます。

    • AWS Cloud9 のチームのセットアップ で 作成した IAM ユーザー。

    • AWS アカウント全体の複数のユーザーの AWS Cloud9 リソースを定期的に操作する場合、 アカウントの IAM 管理者。IAM 管理者として AWS CLI を設定できない場合は、AWS アカウント管理者にチェックしてください。詳細については、「IAM ユーザーガイド」の「最初の IAM 管理者のユーザーおよびグループの作成」を参照してください。

    • AWS アカウントのルートユーザー。ただし、お客様が自分の AWS アカウントを使用する唯一のユーザーであり、環境を他者と共有する必要がない場合に限ります。このオプションはお勧めしません。AWS セキュリティのベストプラクティスではないからです。詳細については、「Amazon Web Services 全般のリファレンス」の「AWS アカウントのアクセスキーの作成、無効化、削除」を参照してください。

    • その他のオプションについては、AWS アカウント管理者またはクラスルームの講師にお問い合わせください。

  2. 以下の 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 および vCPU を備えたインスタンスタイプを指定すると、Amazon EC2 の AWS アカウントに追加料金が発生する可能性があります。利用可能なインスタンスタイプのリストについては、AWS Cloud9 コンソールで環境作成ウィザードを参照してください。

    • EC2 インスタンスの作成に使用される Amazon マシンイメージ (AMI) の識別子を--image-id は指定します。インスタンスに AMI を選択するには、有効な AMI エイリアスまたは有効な AWSSystems Manager (SSM) パスを指定する必要があります。上記の例では、Amazon Linux 2 AMI の SSM パスが指定されています。

      詳細については、AWS CLIコマンドリファレンスの「create-environment-ec2」を参照してください。

    • --region は、AWS Cloud9 で 環境を作成する先の AWS リージョンの ID を表します。利用可能な AWS リージョンのリストについては、「Amazon Web Services 全般のリファレンス」の「AWS Cloud9」を参照してください。

    • --connection-type CONNECT_SSM は、AWS Cloud9 が Systems Manager を介して Amazon EC2 インスタンスに接続することを指定します。このオプションにより、インスタンスへのインバウンドトラフィックが許可されなくなります。詳細については、「AWS Systems Manager を使用して no-ingress EC2 インスタンスにアクセスする」を参照してください。

      注記

      このオプションを使用するときは、AWSCloud9SSMAccessRole サービスロールと AWSCloud9SSMInstanceProfile を作成する必要があります (まだ作成されていない場合)。詳細については、「AWS CLI を使ったSystems Manager のインスタンスプロファイルの管理」を参照してください。

    • --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) を追加します。

  3. このコマンドを正常に実行した後で、新しく作成された環境の AWS Cloud9 IDE を開きます。これを行うには、「AWS Cloud9 で環境を開く」を参照してください。その後、このトピックに戻り、「ステップ 2: IDE のベーシック演習」を続行し、 AWS Cloud9 IDE を使用した新しい環境の操作方法を確認します。

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

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

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

  • editor (エディタ)]ウィンドウを使用して、コードを作成および編集できます。

  • terminal (ターミナル)]ウィンドウまたは[Run Configuration (実行設定)]ウィンドウを使用して、デバッグせずにコードを実行できます。

  • Debugger (デバッガー)]ウィンドウを使用してコードをデバッグできます。

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

環境の準備をする

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

  1. AWS Cloud9 IDE の上部のメニューバーで、[Window] (ウィンドウ)、[New Terminal] (新しいターミナル) の順に選択します。または、既存のターミナルウィンドウを使用します。

  2. ターミナルウィンドウ (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

コードを記述する

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

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

  2. 以下の 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!");
  3. File (ファイル)]、[Save (保存)]の順に選択し、ファイルを hello-cloud9.js として保存します。

コードを実行する

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

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

[Run Configuration (実行設定)]ウィンドウを使用してコードを実行するには
  1. メニューバーで、[Run (実行)]、[Run Configurations (実行設定)]、[New Run Configuration (新しい実行設定)]の順に選択します。

  2. 新しい[設定の実行]ウィンドウ (IDE の下部にあるタブの 1 つ) で、[コマンド]フィールドに「hello-cloud9.js」と入力し、[実行]を選択します。

  3. [Run Configuration] (実行設定) プロンプトがアクティブであることを確認してから、プロンプトで番号を入力してアプリケーションを操作します。

  4. Run Configuration (実行設定)]ウィンドウにコードの出力が表示されます。次のように表示されます。

[Run Configuration (実行設定)]でコードを実行する。
ターミナルウィンドウを使用してコードを実行するには
  1. 先ほど使用したターミナルウィンドウに移動します (または新しいターミナルウィンドウを開きます)。

  2. ターミナルウィンドウのプロンプトで「ls」と入力し、コードファイルがファイルのリストにあることを確認します。

  3. プロンプトで「node hello-cloud9.js」と入力して、アプリケーションを起動します。

  4. プロンプトで番号を入力して、アプリケーションを操作します。

  5. ターミナルウィンドウにコードの出力が表示されます。次のように表示されます。

[Run Configuration (実行設定)]でコードを実行する。

コードをデバッグする

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

  1. 行 10 の横のマージンを選択して、行 10 のコード (if (input === 'q')) にブレークポイントを追加します。以下のように、その行番号の横に赤い円が表示されます。

    コードにブレークポイントを追加する。
  2. IDE の右側で [Debugger] ボタンを選択して、Debugger ウィンドウを開きます。または、メニューバーで [Window (ウィンドウ)]、[Debugger (デバッガー)] の順に選択します。

    次に、[Debugger] (デバッガー) ウィンドウの [Watch Expressions] (ウォッチ式) セクションで [Type an expression here] (ここに式を入力) を選択して、input 変数を監視します。

    [Debugger (デバッガー)]ウィンドウでウォッチを設定する。
  3. コードを実行するために先ほど使用した[Run Configuration (実行設定)]ウィンドウに移動します。[Run(実行) ]を選択します。

    または、新しい [Run Configuration] (実行設定) ウィンドウを開いて、コードの実行を開始することもできます。そのためには、メニューバーから [Run] (実行)、[Run with] (環境を指定して実行)、[Node.js] の順に選択します。

  4. Run Configuration (実行設定)]プロンプトで番号を入力し、コードが行 10 で一時停止することを確認します。[Debugger] (デバッガー) ウィンドウに、[Watch Expressions] (ウォッチ式) に入力した値が表示されます。

    プログラムがブレークポイントで停止する。
  5. [Debugger] (デバッガー) ウィンドウで、[Resume] (再開) を選択します。これは、前のスクリーンショットで強調表示されている青い矢印アイコンです。

  6. [設定の実行] ウィンドウで [停止] を選択し、デバッガーを停止します。

    環境の詳細ページで環境を削除する

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

このチュートリアルに関連した AWS アカウントで料金が継続的に発生するのを防ぐには、環境を削除します。

警告

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

Delete the Environment by using the AWS Cloud9 console
  1. ダッシュボードを開くには、IDE のメニューバーで、[AWS Cloud9]、[Go To Your Dashboard (ダッシュボードを開く)]を選択します。

  2. 次のいずれかを行います。

    • my-demo-environment]カード内のタイトルを選択し、もう一度[Delete (削除)]を選択します。

      環境の詳細ページで環境を削除する
    • my-demo-environment]を選択し、次に[Delete (削除)]を選択します。

      環境リストで環境を削除する
  3. Delete (削除)]ダイアログボックスに「Delete」と入力し、[Delete (削除)]を選択します。削除オペレーションには数分かかります。

注記

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

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

Delete the Environment with the AWS CLI
  1. AWS Cloud9 delete-environment コマンドを実行します。削除する環境の ID を指定します。

    aws cloud9 delete-environment --region MY-REGION --environment-id 12a34567b8cd9012345ef67abcd890e1

    上記のコマンドで、MY-REGION を、環境が作成された AWS リージョンと置き換え、12a34567b8cd9012345ef67abcd890e1 を削除する環境の ID に置き換えます。

    環境の作成時に ID を保存しなかった場合、ID は AWS Cloud9 コンソールを使用して見つけることができます。コンソールで環境の名前を選択し、[Environment ARN (環境 ARN)]の最後の部分を見つけます。

  2. このチュートリアル用に Amazon VPC を作成し、不要になった場合は、Amazon VPC コンソールを使用して VPC を削除します (https://console.aws.amazon.com/vpc)。

関連情報

AWS Cloud9 コンソールの使用開始方法に関する追加情報を次に示します。

  • EC2 環境を作成する場合、デフォルトでは環境にサンプルコードは含まれていません。サンプルコードを使って環境を作成するには、以下のいずれかのトピックを参照してください。

  • AWS Cloud9 開発環境の作成中に、Amazon EC2 インスタンスを作成するよう AWS Cloud9 に指示します。AWS Cloud9 はそのインスタンスを作成して環境と接続します。別の方法として、既存のクラウドコンピューティングインスタンスや独自のサーバー (SSH 環境と呼ばれます) を使用することもできます。詳細については、「AWS Cloud9 で環境を作成する」を参照してください。

次のステップ (オプション)

以下のトピックのすべてあるいは一部に目を通して、AWS Cloud9 についての理解を深めてください。

タスク 次のトピックを参照

環境で何ができるかに関する詳細はこちら。

AWS Cloud9 の環境を使用する

他のコンピュータ言語を試します。

AWS Cloud9 のチュートリアル

AWS Cloud9 IDE の詳細はこちら。

IDE を操作するAWS Cloud9 IDE のツアー

テキストチャットサポートにより、リアルタイムで新しい環境を使用するように他のユーザーを招待します。

AWS Cloud9 で共有環境を使用する

SSH 環境の作成 これらの環境では、AWS Cloud9 がユーザーに代わって作成した Amazon EC2 インスタンスではなく、ユーザーが作成したクラウドコンピューティングインスタンスまたはサーバーを使用します。

AWS Cloud9 で環境を作成する および SSH 環境ホスト要件

AWS ツールキットを使用して、AWS Lambda 関数およびサーバーレスアプリケーションでコードを作成、実行、デバッグします。

AWS ツールキットを使った AWS Lambda 関数の使用

AWS Cloud9 は Amazon Lightsail と併用してください。

AWS Cloud9 IDE での Amazon Lightsail インスタンスの操作

AWS Cloud9 は AWS CodeStar と併用してください。

AWS Cloud9 IDE での AWS CodeStar プロジェクトの操作

AWS Cloud9 は AWS CodePipeline と併用してください。

AWS Cloud9 での AWS CodePipeline IDE の使用

AWS Cloud9 は、AWS CLI、AWS CloudShell、AWS CodeCommit、AWS Cloud Development Kit (AWS CDK)、GitHub、または Amazon DynamoDB で使用したり、Node.js、Python などのプログラミング言語使用したりします。

AWS Cloud9 のチュートリアル

AWS RoboMaker でインテリジェントなロボット工学アプリケーションのコードを使用します。

AWS RoboMaker デベロッパーガイドAWS Cloud9 による開発

コミュニティから AWS Cloud9 のヘルプを取得するには、「AWS Cloud9 ディスカッションフォーラム」を参照してください。(このフォーラムにアクセスするには AWS へのサインインが必要になることがあります)。

AWS から直接 AWS Cloud9 のサポートを得るには、AWS サポートページでサポートオプションを参照してください。