macOS での AWS CLI バージョン 2 のインストール、更新、アンインストール - AWS Command Line Interface

Python 2.7、3.4、および 3.5 は、AWS CLI バージョン 1 に対して非推奨です。詳細については、「AWS CLI バージョンについて」の AWS CLI バージョン 1 セクションを参照してください。

macOS での AWS CLI バージョン 2 のインストール、更新、アンインストール

このトピックでは、macOS で AWS CLI バージョン 2 をインストール、更新、削除する方法について説明します。

重要

AWS CLI バージョン 1 と 2 では同じ aws コマンド名が使用されます。両方のバージョンがインストールされている場合、コンピュータによって検索パスで最初に見つかったバージョンが使用されます。以前に AWS CLI バージョン 1 をインストールしていた場合は、AWS CLI バージョン 2 を使用するために次のいずれかを実行することをお勧めします。

  • 推奨 – AWS CLI バージョン 1 をアンインストールし、AWS CLI バージョン 2 のみを使用してください。アンインストール手順については、AWS CLI バージョン 1 のインストールに使用した方法を確認し、AWS CLI バージョン 1 のインストール、更新、アンインストール にあるお使いのオペレーティングシステム向けのアンインストール手順に従ってください。

  • オペレーティングシステムの機能を使用して、2 つの aws コマンドのいずれかに対して異なる名前でシンボリックリンクまたはエイリアスを作成します。例えば、Linux および macOS ではシンボリックリンクまたはエイリアスを使用でき、Windows では DOSKEY を使用できます。

バージョン 1 とバージョン 2 との間の重要な変更については、「破壊的変更 - AWS CLI バージョン 1 からバージョン 2 への移行」を参照してください。

Prerequisites

  • AWS CLI バージョン 2 は、Apple がサポートしているバージョンの 64 ビット macOS でサポートされています。

  • AWS はサードパーティーのリポジトリのメンテナンスを行っていないため、最新バージョンの AWS CLI が含まれていることは保証できません。

macOS ユーザーインターフェイスを使用した AWS CLI バージョン 2 のインストールと更新

以下のステップは、標準の macOS ユーザーインターフェイスとブラウザを使用して AWS CLI バージョン 2 の最新バージョンをインストール、または最新バージョンに更新する方法を説明しています。最新バージョンに更新する場合は、現在のバージョンに使用したのと同じインストール方法を使用します。

  1. ブラウザで、macOS pkg ファイルをダウンロードします。

  2. ダウンロードしたファイルをダブルクリックして、インストーラを起動します。

  3. 画面上の指示に従ってください。AWS CLI バージョン 2 は以下の方法でインストールできます。

    • コンピュータ上のすべてのユーザーが対象 ( が必要)sudo

      • 任意のフォルダにインストールするか、推奨されるデフォルトのフォルダ /usr/local/aws-cli を選択できます。

      • インストーラによって、選択したインストールフォルダ内のメインプログラムにリンクするシンボリックリンクが /usr/local/bin/aws に自動的に作成されます。

    • 現在のユーザーのみが対象 ( は不要)sudo

      • 書き込みアクセス許可がある任意のフォルダにインストールできます。

      • 標準のユーザー権限により、インストーラの完了後に、コマンドプロンプトで次のコマンドを使用して、$PATH および aws プログラムを指すシンボリックリンクファイルを aws_completer で手動で作成する必要があります。$PATH に書き込み可能なフォルダが含まれている場合、そのフォルダをターゲットのパスとして指定すると、sudo なしで以下のコマンドを実行できます。$PATH に書き込み可能なフォルダが含まれていない場合は、コマンドで sudo を使用して、指定したターゲットフォルダに対する書き込みアクセス許可を取得する必要があります。シンボリックリンクのデフォルトの場所は /usr/local/bin/ です。

        $ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws $ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
    注記

    インストーラの任意の場所で Cmd + L キーを押すと、インストールのデバッグログを表示できます。これにより、ログをフィルタ処理して保存できるログペインが開きます。また、ログファイルは /var/log/install.log に自動的に保存されます。

  4. AWS CLI バージョン 2 がインストールされたことを確認するには、「インストールの検証」のステップを実行します。

macOS コマンドラインを使用した AWS CLI バージョン 2 のインストールと更新

コマンドラインからダウンロード、インストール、および更新を実行できます。最新バージョンに更新する場合は、現在のバージョンで使用したのと同じインストール方法を使用します。AWS CLI バージョン 2 は、次のいずれかの方法でインストールできます。

macOS コマンドラインを使用してすべてのユーザーを対象にインストールおよび更新するには

sudo 許可がある場合は、コンピュータ上のすべてのユーザーのために AWS CLI バージョン 2 をインストールできます。

AWS では、1 つの簡単な手順でグループのコピーと貼り付けができます。以下のステップの各行の説明を参照してください。

AWS CLI の最新バージョンの場合は、次のコマンドブロックを使用します。

$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg" $ sudo installer -pkg AWSCLIV2.pkg -target /

AWS CLI の特定バージョンの場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン 2.0.30 のファイル名が AWSCLIV2-2.0.30.pkg になるため、コマンドは以下のようになります。

$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg" $ sudo installer -pkg AWSCLIV2.pkg -target /

バージョンのリストについては、GitHubAWS CLI version 2 changelog を参照してください。

  1. curl コマンドを使用して、ファイルをダウンロードします。-o オプションは、ダウンロードしたパッケージを書き込むファイル名を指定します。この例では、ファイルは現在のフォルダ内の AWSCLIV2.pkg に書き込まれます。

    AWS CLI の最新バージョンの場合は、次のコマンドブロックを使用します。

    $ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"

    AWS CLI の特定バージョンの場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン 2.0.30 のファイル名が AWSCLIV2-2.0.30.pkg になるため、コマンドは以下のようになります。

    $ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"

    バージョンのリストについては、GitHubAWS CLI version 2 changelog を参照してください。

  2. ダウンロードした installer ファイルをソースとして指定して、標準の macOS .pkg プログラムを実行します。-pkg パラメータを使用して、インストールするパッケージの名前、およびパッケージをインストールするドライブの -target / パラメータを指定します。ファイルは /usr/local/aws-cli にインストールされ、シンボリックリンクが /usr/local/bin に自動的に作成されます。これらのフォルダに対する書き込みアクセス許可を付与するには、コマンドに sudo を含める必要があります。

    $ sudo installer -pkg ./AWSCLIV2.pkg -target /

    インストールが完了すると、デバッグログが /var/log/install.log に書き込まれます。

  3. AWS CLI バージョン 2 がインストールされたことを確認するには、「インストールの検証」のステップを実行します。

macOS コマンドラインを使用して現在のユーザーのみを対象にインストールおよび更新するには

  1. AWS CLI のインストール先フォルダを指定するには、XML ファイルを作成する必要があります。このファイルは、以下の例のような XML 形式のファイルです。値はすべてそのままにしておきます。ただし、9 行目のパス /Users/myusername は、AWS CLI CLI バージョン 2 をインストールするフォルダへのパスに置き換える必要があります。フォルダはすでに存在している必要があります。存在しない場合、コマンドは失敗します。 この XML の例では、インストーラによってフォルダ AWS CLI に /Users/myusername という名前のフォルダが作成され、そこに aws-cli がインストールされることを指定します。

    <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <array> <dict> <key>choiceAttribute</key> <string>customLocation</string> <key>attributeSetting</key> <string>/Users/myusername</string> <key>choiceIdentifier</key> <string>default</string> </dict> </array> </plist>
  2. pkg コマンドを使用して curl インストーラをダウンロードします。-o オプションは、ダウンロードしたパッケージを書き込むファイル名を指定します。この例では、ファイルは現在のフォルダ内の AWSCLIV2.pkg に書き込まれます。

  3. AWS CLI の最新バージョンの場合は、次のコマンドブロックを使用します。

    $ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"

    AWS CLI の特定バージョンの場合は、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン 2.0.30 のファイル名が AWSCLIV2-2.0.30.pkg になるため、コマンドは以下のようになります。

    $ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"

    バージョンのリストについては、GitHubAWS CLI version 2 changelog を参照してください。

  4. 以下のオプションを使用して、標準の macOS installer プログラムを実行できます。

    • -pkg パラメータで、インストールするパッケージの名前を指定します。

    • -target パラメータを CurrentUserHomeDirectory に設定して、現在のユーザーのみへのインストールを指定します。

    • -applyChoiceChangesXML パラメータで作成した XML ファイルのパス (現在のフォルダへの相対パス) と名前を指定します。

    次の例では、フォルダ AWS CLI に /Users/myusername/aws-cli をインストールします。

    $ installer -pkg AWSCLIV2.pkg \ -target CurrentUserHomeDirectory \ -applyChoiceChangesXML choices.xml
  5. 通常、標準のユーザーアクセス許可では $PATH 内のフォルダへの書き込みが許可されないため、このモードのインストーラは aws および aws_completer プログラムにシンボリックリンクを追加しようとしません。AWS CLI を正しく実行するには、インストーラの完了後にシンボリックリンクを手動で作成する必要があります。$PATH に書き込み可能なフォルダが含まれていて、そのフォルダをターゲットのパスとして指定すると、sudo なしで以下のコマンドを実行できます。$PATH に書き込み可能なフォルダが含まれていない場合は、sudo を使用して、指定したターゲットフォルダに対する書き込みアクセス許可を取得する必要があります。シンボリックリンクのデフォルトの場所は /usr/local/bin/ です。

    $ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws $ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer

    インストールが完了すると、デバッグログが /var/log/install.log に書き込まれます。

  6. AWS CLI バージョン 2 がインストールされたことを確認するには、「インストールの検証」のステップを実行します。

インストールの検証

シェルが aws$PATH コマンドを検索して実行できることを確認するには、次のコマンドを使用します。aws コマンドが見つからない場合は、ターミナルの再起動が必要になる場合があります。

$ which aws /usr/local/bin/aws $ aws --version aws-cli/2.1.29 Python/3.7.4 Darwin/18.7.0 botocore/2.0.0

AWS CLI バージョン 2 のアンインストール

AWS CLI バージョン 2 をアンインストールするには、次のコマンドのパスをインストールに使用したパスに置き換えてから実行します。

  1. メインプログラムとコンプリータへのシンボリックリンクを含むフォルダを見つけます。

    $ which aws /usr/local/bin/aws
  2. この情報を使用して次のコマンドを実行し、シンボリックリンクが指すインストールフォルダを見つけます。

    $ ls -l /usr/local/bin/aws lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/aws
  3. 最初のフォルダの 2 つのシンボリックリンクを削除します。ユーザーアカウントにこれらのフォルダに対する書き込みアクセス許可がある場合は、sudo を使用する必要はありません。

    $ sudo rm /usr/local/bin/aws $ sudo rm /usr/local/bin/aws_completer
  4. メインインストールフォルダを削除します。sudo を使用して、/usr/local フォルダに対する書き込みアクセス許可を取得します。

    $ sudo rm -rf /usr/local/aws-cli