AWS Cloud9
ユーザーガイド

AWS Cloud9 の AWS Command Line Interface および aws-shell のサンプル

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

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

AWS とやり取りするために AWS CLI で実行できるコマンドのリストについては、「AWS CLI Command Reference」を参照してください。一部のコマンドは aws-shell でも使用できます。ただし 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. 環境 が開いている状態で、aws-shell がインストール済みであるかどうかを IDE で確認します。ターミナルで aws-shell コマンドを実行します。(新しいターミナルセッションを開始するには、メニューバーで、[Window (ウィンドウ)]、[New Terminal (新しいターミナル)] の順に選択します。) aws-shell がインストールされている場合は、aws> プロンプトが表示されます。aws-shell がインストール済みである場合は、「ステップ 2: 環境 で認証情報管理を設定する」に進んでください。

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

    Python がインストール済みであるかどうかを確認 (および必要に応じてインストール) するには、Python のサンプルの「ステップ 1: 必要なツールをインストールする」の手順を実行してから、このトピックに戻ってください。

    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 Command Reference の「s3 コマンド」も参照してください(バケットを削除しない場合、AWS アカウントで継続的に料金が発生する可能性があることに注意してください)。

AWS CLI を使用して実験を続行するには、AWS Command Line Interface ユーザーガイド の「アマゾン ウェブ サービスの使用」、および AWS CLI Command Reference を参照してください。aws-shell を使用して実験を続行するには、AWS CLI Command Reference を参照してください。コマンドを実行するときに aws プレフィックスを付けないことに注意してください。

手順 4: クリーンアップ

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

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