AWS Cloud9 に関する AWS Command Line Interface および aws-shell のチュートリアル

以下のチュートリアルでは、AWS Command Line Interface (AWS CLI)、aws-shell、またはその両方を AWS Cloud9 開発環境でセットアップできます。AWS CLI および aws-shell は、AWS のすべてのパートを操作するための一貫したインターフェイスを提供する統合ツールです。AWS Management Console の代わりに AWS CLI を使用してコマンドをすばやく実行し、AWS を操作できます。一部のコマンドは AWS CLI または AWS CloudShell を使用して実行できます。

AWS CLI の詳細については、AWS Command Line Interface ユーザーガイドを参照してください。aws-shell については、以下のリソースを参照してください。

• GitHub ウェブサイトの「aws-shell」

• pip ウェブサイトの「aws-shell」

AWS とやり取りするために AWS CLI で実行できるコマンドのリストについては、AWS CLI コマンドリファレンスを参照してください。同じコマンドを AWS CloudShell でも使用できますが、aws プレフィックスを付けずにコマンドを開始します。

このサンプルを作成すると、AWS アカウントに課金される場合があります。Amazon EC2 や Amazon S3 などのサービスに対して発生する可能性がある料金も含まれます。詳細については、「Amazon EC2 料金表」および「Amazon S3 料金表」を参照してください。

前提条件

このサンプルを使用する前に、設定が次の要件を満たしていることを確認します。

• 既存の AWS Cloud9 EC2 開発環境が存在している必要があります。このサンプルは、Amazon Linux または Ubuntu Server を実行する Amazon EC2 インスタンスに接続された EC2 環境が既にあることを前提としています。別のタイプの環境またはオペレーティングシステムがある場合、このサンプルの指示を関連ツールを設定する必要がある場合があります。詳細については、「AWS Cloud9 で環境を作成する」を参照してください。

• 既存の環境に既に AWS Cloud9 IDE が開いています。環境を開くと、AWS Cloud9 によってその環境の IDE がウェブブラウザで開かれます。詳細については、「AWS Cloud9 で環境を開く」を参照してください。

ステップ 1: AWS CLI、aws-shell、またはその両方を環境にインストールする

このステップでは、AWS Cloud9 IDE を使用して、AWS CLI、aws-shell、またはその両方を環境 にインストールし、AWS を操作するコマンドを実行できるようにします。

:AWS Cloud9 EC2 開発環境を使用しており、AWS CLI だけを使用したい場合は、ステップ 3: 環境で AWS CLIまたは aws-shell のベーシックコマンドを実行する までスキップできます。AWS CLI が EC2 環境にインストール済みであり、 AWS アクセス認証情報のセットが環境に設定済みであるためです。詳細については、「AWS 管理対象の一時認証情報」を参照してください。

EC2 環境を使用していない場合は、以下を実行して AWS CLI をインストールします。

1. 環境が開いている状態で、AWS CLI がインストール済みであるかどうかを IDE 内でチェックします。ターミナルで aws --version コマンドを実行します。(新しいターミナルセッションを開始するには、メニューバーで、［ Window (ウィンドウ)］ 、［ New Terminal (新しいターミナル)］ の順に選択します。) AWS CLI がインストール済みである場合は、バージョン番号が表示されます。 Amazon EC2 インスタンスまたは独自のサーバーの Python バージョン番号やオペレーティングシステムのバージョン番号などの情報も表示されます。AWS CLI がインストール済みである場合は、「ステップ 2: 環境で認証情報管理を設定する」に進んでください。

2. AWS CLI をインストールするには、 AWS Command Line Interface ユーザーガイドの「AWS Command Line Interface をインストールする」を参照してください。たとえば、Amazon Linux を実行するEC2 環境の場合は、ターミナルで次の 3 つのコマンドを 1 つずつ実行して、AWS CLI をインストールします。

   sudo yum -y update          # Install the latest system updates.
   sudo yum -y install aws-cli # Install the AWS CLI.
   aws --version               # Confirm the AWS CLI was installed.

   Ubuntu Server を実行する EC2 環境の場合は、ターミナルで代わりに次の 3 つのコマンドを 1 つずつ実行して、AWS CLI をインストールします。

   sudo apt update             # Install the latest system updates.
   sudo apt install -y awscli  # Install the AWS CLI.
   aws --version               # Confirm the AWS CLI was installed.

aws-shell をインストールする場合は、以下を実行します。

1. 環境が開いている状態で、IDE で aws-shell が既にインストールされているかどうかをチェックします。ターミナルで aws-shell コマンドを実行します。(新しいターミナルセッションを開始するには、メニューバーで、［ Window (ウィンドウ)］ 、［ New Terminal (新しいターミナル)］ の順に選択します。) aws-shell がインストールされている場合は、aws> プロンプトが表示されます。aws-shell がインストール済みである場合は、「ステップ 2: 環境で認証情報管理を設定する」に進んでください。

2. aws-shell をインストールするには、pip を使用します。pip を使用するには、Python がインストールされている必要があります。

   Python が既にインストールされているかどうかをチェックするには (および必要に応じてインストールするには)、Python のサンプルの ステップ 1: Python をインストールする にある指示に従ってから、このトピックに戻ってください。

   pip がインストール済みであるかどうかを確認するには、ターミナルで、pip --version コマンドを実行します。pip がインストールされている場合は、バージョン番号が表示されます。pip がインストールされていない場合は、ターミナルで次の 3 つのコマンドを 1 つずつ実行して、pip をインストールします。

   wget https://bootstrap.pypa.io/get-pip.py # Get the pip install file.
   sudo python get-pip.py                    # Install pip. (You might need to run 'sudo python2 get-pip.py' or 'sudo python3 get-pip.py' instead, depending on how Python is installed.)
   rm get-pip.py                             # Delete the pip install file, as it is no longer needed.

3. pip を使用して aws-shell をインストールするには、次のコマンドを実行します。

   sudo pip install aws-shell

ステップ 2: 環境で認証情報管理を設定する

AWS CLI または aws-shell を使用して AWS サービスを呼び出すたびに、呼び出しとともに一連の認証情報を指定する必要があります。これらの認証情報は AWS CLI または aws-shell にその呼び出しを行う適切なアクセス許可があるかどうかを判別します。認証情報に適切なアクセス権限がない場合は、呼び出しは失敗します。

AWS Cloud9 EC2 開発環境を使用している場合、ステップ 3: 環境で AWS CLIまたは aws-shell のベーシックコマンドを実行する までスキップできます。これは、認証情報が既に EC2 環境で設定されているためです。詳細については、「AWS 管理対象の一時認証情報」を参照してください。

EC2 環境を使用していない場合は、手動で環境内に認証情報を保存する必要があります。これを行うには、AWS Cloud9 の環境から AWS のサービス の呼び出し の指示を実行してから、このトピックに戻ります。

ステップ 3: 環境で AWS CLIまたは aws-shell のベーシックコマンドを実行する

このステップでは、環境で AWS CLI または aws-shell を使用して、Amazon S3 でバケットを作成し、使用可能なバケットを一覧表示した後、バケットを削除します。

1. aws-shell を使用するがまだ起動していない場合は、aws-shell コマンドを実行して aws-shell を起動します。aws> プロンプトが表示されます。

2. バケットを作成します。作成するバケットの名前を指定して、AWS CLI で aws s3 mb コマンドを実行するか、aws-shell で s3 mb コマンドを実行します。この例では、cloud9-123456789012-bucket という名前のバケットを使用します。ここで 123456789012 はお客様の AWS アカウント ID です。別の名前を使用する場合は、このステップ全体でそれを置き換えてください。

   aws s3 mb s3://cloud9-123456789012-bucket # For the AWS CLI.
   s3 mb s3://cloud9-123456789012-bucket     # For the aws-shell.

   注記

   バケット名は AWS アカウントで一意であるだけでなく、AWS 全体で一意である必要があります。上記で提案されたバケット名は、一意のバケット名を作成するために便利です。BucketAlreadyExists というエラーを含むメッセージが表示された場合は、別のバケット名で再度コマンドを実行する必要があります。

3. 使用可能なバケットを一覧表示します。AWS CLI で aws s3 ls コマンドを実行するか、aws-shell で s3 ls コマンドを実行します。使用可能なバケットのリストが表示されます。

4. バケットを削除します。削除するバケットの名前を指定して、AWS CLI で aws s3 rb コマンドを実行するか、aws-shell で s3 rb コマンドを実行します。

   aws s3 rb s3://cloud9-123456789012-bucket # For the AWS CLI.
   s3 rb s3://cloud9-123456789012-bucket     # For the aws-shell.

   バケットが削除されたかどうかを確認するには、AWS CLI で aws s3 ls コマンドを再度実行するか、aws-shell で s3 ls コマンドを再度実行します。削除されたバケットの名前がリストに表示されていないことを確認します。

   注記

   バケットを使用し続ける場合は、削除する必要はありません。詳細については、Amazon Simple Storage Service ユーザーガイドのバケットへのオブジェクトの追加を参照してください。AWS CLIコマンドリファレンスにある s3 コマンドも参照してください。(バケットを削除しない場合、AWS アカウントで継続的に料金が発生する可能性があることに注意してください)。

AWS CLI を使用して実験を続行するには、AWS CLI コマンドリファレンス だけではなく、AWS Command Line Interface ユーザーガイド における「Amazon Web Servicesの使用」を参照してください。aws-shell を使用して実験を続行するには、AWS CLI コマンドリファレンスを参照してください。コマンドをスタートするときに aws プレフィックスを付けないように注意してください。

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

aws-shell を使用している場合、.exit コマンドまたは .quit コマンドを実行して使用を停止できます。

このサンプルを使用し終わった後 AWS アカウントで料金が継続的に発生するのを防ぐには、環境を削除する必要があります。手順については、「AWS Cloud9 で環境を削除する」を参照してください。