‹ ハウツー に戻る

Amazon Lightsail コンテナサービスプラグインのインストール

最終更新日: 2020 年 2 月 23 日

Amazon Lightsail コンソールを使用して Lightsail コンテナサービスを作成すると、Amazon ECR Public Gallery などのオンライン公開レジストリからコンテナイメージを使ってデプロイを作成できます。独自のコンテナイメージを作成してコンテナサービスにプッシュするには、コンテナイメージを作成する予定のコンピューター上に、以下の追加ソフトウェアをインストールする必要があります。

  • Docker – 独自のコンテナイメージを実行、テスト、作成することが可能で、イメージは Lightsail コンテナサービスで使用することができます。

  • AWS Command Line Interface (AWS CLI) – 作成したコンテナイメージのパラメータを指定し、それらをLightsail コンテナサービスにプッシュすることができます。バージョン 2.1.1 とそれ以降のバージョンで、Lightsail コントロールプラグインは機能します。

  • Lightsail コントローラー (lightsailctl) プラグイン – ローカルマシン上にあるコンテナイメージへのAWS CLI のアクセスを可能にします。

このガイドの次のセクションでは、これらのソフトウェアパッケージをダウンロードする場所と、インストール方法について説明しています。コンテナサービスの詳細については、「Amazon Lightsail のコンテナサービス」を参照してください。

目次

Docker をインストールする

Docker は、Linux コンテナをベースにしている配信されたアプリケーションの構築、実行、テスト、そしてデプロイを可能にするテクノロジーです。Lightsail コンテナサービスで使用することができる独自のコンテナイメージを作成したい場合は、Docker ソフトウェアをインストールして使用する必要があります。詳細については、「Amazon Lightsailコンテナサービスでのコンテナイメージの作成」を参照してください。

Docker はさまざまなオペレーティングシステムで使用できます。Ubuntu のような最新の Linux ディストリビューションや、 macOS や Windows でも使用できます。特定のオペレーティングシステムに Docker をインストールする方法の詳細については、Docker インストールガイド を参照してください。

注意

Docker の最新バージョンがインストールされている必要があります。古いバージョンの Docker は、このガイドで後述される AWS CLI や Lightsail コントローラー (lightsailctl) プラグインで動作する保証はありません。

AWS CLI をインストールする

AWS CLI はオープンソースツールで、ユーザーはコマンドラインシェルのコマンドを使って Lightsail などの AWS のサービスと交信することが可能になります。ローカルマシンで作成されたコンテナイメージを Lightsail コンテナサービスにプッシュするには、AWS CLI をインストールして使用する必要があります。

AWS CLI は以下のバージョンで利用可能です。

  • バージョン 2.x — 現在一般的にご利用いただける AWS CLI のリリース。AWS CLI の最新のメジャーバージョンです。最新の機能をすべてサポートしており、コンテナイメージを Lightsail コンテナサービスにプッシュする機能などを含んでいます。バージョン 2.1.1 とそれ以降のバージョンで、Lightsail コントロールプラグインは機能します。

  • バージョン 1.x - AWS CLI の以前のバージョンで、後方互換性が備わっています。このバージョンでは、コンテナイメージを Lightsail コンテナサービスにプッシュする機能がサポートされていません。そのため、代わりに AWS CLI のバージョン 2 をインストールする必要があります。

AWS CLI バージョン 2 は、Linux、macOS、Windows のオペレーティングシステムで使用できます。これらのオペレーティングシステムに AWS CLI をインストールする方法については、AWS CLI ユーザーガイドの「AWS CLI バージョン 2 のインストール」をご確認ください。

Lightsail コントローラー プラグインをインストールする

Lightsail コントローラー (lightsailctl) プラグインは、ローカルマシーンに作成されたコンテナイメージに AWS CLI がアクセスできるようにする軽量アプリケーションです。このプラグインは、コンテナイメージを Lightsail コンテナサービスにプッシュすることで、それらをご自身のサービスにデプロイできるようにします。

システム要件

  • 64 ビット対応の Windows、macOS、および Linux オペレーティングシステム。

  • lightsailctl プラグインを使用するには、AWS CLI バージョン 2 をローカルマシンにインストールする必要があります。詳細については、このガイドの前のセクションにあった AWS CLI をインストールするを参照してください。

最新バージョンの lightsailctl プラグインを使用する

lightsailctl プラグインは、機能強化のために時折更新されます。lightsailctl プラグインを使用する際は、最新バージョンを使用していることを確認するためのチェックが毎回実行されます。新しいバージョンが利用可能であることが判明した場合は、最新バージョンに更新して新しい機能を利用するように求められます。最新バージョンが利用可能な場合は、インストレーションのプロセスを繰り返して lightsailctl プラグインの最新バージョンを取得する必要があります。

以下の一覧は、lightsailctl プラグインのすべてのリリースと、各バージョンに含まれる機能と強化の一覧です。

  • v1.0.0 (2020 年 11 月 12 日リリース) — 初期リリースでは、AWS CLI バージョン 2 の機能が追加され、コンテナイメージを Lightsail コンテナサービスにプッシュすることが可能になりました。

Windows に lightsailctl プラグインをインストールする

Windows に lightsailctl プラグインをインストールするには、次の手順を実行します。

  1. 次の URL から実行可能ファイルをダウンロードして、C:\Temp\lightsailctl\ ディレクトリに保存します。

    https://s3.us-west-2.amazonaws.com/lightsailctl/latest/windows-amd64/lightsailctl.exe

  2. Windows Start ボタンを選択して、cmd を検索します。

  3. 検索結果から Command Prompt アプリケーションを右クリックし、[Run as administrator] を選択します。

    管理者として Run Command Prompt を実行する

    注意

    デバイスに変更を加えることを Command Prompt に許可するかの確認プロンプトが表示される場合があります。はい を選択してインストールを続行します。

  4. 次のコマンドを入力してパス環境可変を設定すると、 lightsailctl プラグインを保存している C:\Temp\lightsailctl\ ディレクトリが指定されます。

    setx PATH "%PATH%;C:\Temp\lightsailctl" /M

    次の例のような結果が表示されます。

    setx コマンドに対するコマンドライン応答

setx コマンドは 1,024 文字を超えると切り捨てられます。PATH に複数の変数がすでに設定されている場合は、以下の手順を使用して PATH 環境変数を手動で設定します。

  1. [Start] (スタート) メニューから [Control Panel] (コントロールパネル) を開きます。

  2. [System and Security] (システムとセキュリティ) を選択し、[System] (システム) を選択します。

  3. [システムの詳細設定] を選択します。

  4. [System Properties] (システムのプロパティ) ダイアログボックスで、[Advanced] (詳細設定) タブを開き、[Environment Variables] (環境変数) を選択します。

  5. [Environment Variables] (環境変数) ダイアログボックスの [System Variables] (システム変数) ボックスで、[Path] (パス) を選択します。

  6. [System Variables] (システム変数) ボックスの下にある [Edit] (編集) ボタンを選択します。

    Windows システム変数

  7. [New] (新規) を選択し、次のパスを入力します。C:\Temp\lightsailctl\

    Windows 環境変数

  8. 3 つの連続したダイアログボックスで [OK] を選択し、[System] (システム) ダイアログボックスを閉じます。

これで AWS Command Line Interface (AWS CLI) を使用してコンテナイメージを Lightsail コンテナサービスにプッシュする準備が整います。詳細については、「Amazon Lightsail コンテナサービスのコンテナイメージのプッシュと管理」を参照してください。

macOS に lightsailctl プラグインをインストールする

macOS に lightsailctl プラグインをダウンロードしてインストールするには、以下のいずれかの手順を実行してください。

    ホームブリューダウンロードとインストール

  1. ターミナルウィンドウを開きます。

  2. 次のコマンドを入力して、lightsailctl プラグインのダウンロードとインストールを行います。

    brew install aws/tap/lightsailctl

    注意

    Homebrew の詳細については、Homebrew ウェブサイトを参照してください。

    手動のダウンロードとインストール

  1. ターミナルウィンドウを開きます。

  2. 次のコマンドを入力して、lightsailctl プラグインをダウンロードし、bin フォルダにコピーします。

    curl "https://s3.us-west-2.amazonaws.com/lightsailctl/latest/darwin-amd64/lightsailctl" -o "/usr/local/bin/lightsailctl"

  3. 次のコマンドを入力して、実行可能なプラグインを作成します。

    chmod +x /usr/local/bin/lightsailctl

  4. 次のコマンドを入力して、プラグインの拡張属性をクリアにします。

    xattr -c /usr/local/bin/lightsailctl

これで AWS CLI を使用してコンテナイメージをLightsailコンテナサービスにプッシュする準備が整いました 詳細については、「Amazon Lightsailコンテナサービスのコンテナイメージのプッシュと管理」を参照してください。

Linux に lightsailctl プラグインをインストールする

Linux に Lightsail コンテナサービスプラグインをインストールするには、次の手順を実行します。

  1. ターミナルウィンドウを開きます。

  2. 次のコマンドを入力して、lightsailctl プラグインをダウンロードします。

    • AMD 64 ビットのアーキテクチャーバージョンのプラグインの場合：

      curl "https://s3.us-west-2.amazonaws.com/lightsailctl/latest/linux-amd64/lightsailctl" -o "/usr/local/bin/lightsailctl"

    • ARM 64 ビットのアーキテクチャーバージョンのプラグインの場合：

      curl "https://s3.us-west-2.amazonaws.com/lightsailctl/latest/linux-arm64/lightsailctl" -o "/usr/local/bin/lightsailctl"

  3. 次のコマンドを入力して、実行可能なプラグインを作成します。

    sudo chmod +x /usr/local/bin/lightsailctl

    これで AWS CLI を使用してコンテナイメージをLightsailコンテナサービスにプッシュする準備が整いました 詳細については、Amazon Lightsail コンテナサービスのコンテナイメージのプッシュと管理を参照してください。

必要なソフトウェアをインストールした後の次の手順

必要なソフトウェアをインストールしたら、ローカルマシンでコンテナイメージの作成を開始してください。詳細については、「Amazon Lightsail コンテナサービスでのコンテナイメージの作成」を参照してください。

コンテナイメージを作成した後、デプロイの準備が整ったらそれらを Lightsail コンテナサービスにプッシュします。詳細については、「Amazon Lightsail コンテナサービスのコンテナイメージのプッシュと管理」を参照してください。

コンテナサービスに関する追加情報

これらはLightsail コンテナサービスが起動して実行中になった後に行う、一般的な管理ステップです。

  1. Lightsail コンテナサービスの基礎に慣れましょう。詳細については、「Amazon Lightsail のコンテナサービス」を参照してください。

  2. Lightsail アカウントにコンテナサービスを作成する。詳細については、「Amazon Lightsail コンテナサービスの作成」を参照してください。

  3. 公開レジストリのコンテナイメージを使用する場合は、Amazon ECR Public Gallery などの公開レジストリから使用するコンテナイメージを探します。Amazon ECR Public の詳細については、Amazon ECR Public ユーザーガイドの「Amazon 伸縮自在なコンテナレジストリ公開とは?」を参照してください。

  4. ローカルマシンからコンテナイメージをユーザーのサービスにプッシュする場合は、独自のコンテナイメージを作成する必要のあるローカルマシンにソフトウェアをインストールし、コンテナイメージをLightsail コンテナサービスにプッシュします。詳細については、以下のガイドを参照してください。

  5. コンテナを設定して起動するデプロイをコンテナサービス内に作成します。詳細については、「Amazon Lightsail コンテナサービスのデプロイの作成と管理」を参照してください。

  6. コンテナサービスの以前のデプロイを表示します。以前のデプロイ バージョンを使用して、新しいデプロイを作成できます。詳細については、「Amazon Lightsail コンテナサービスのデプロイ バージョンの表示と管理」を参照してください。

  7. コンテナサービスのコンテナのログを表示します。詳細については、「Amazon Lightsail コンテナサービスのコンテナのログを表示」を参照してください。

  8. コンテナで使用するドメイン用の SSL/TLS 証明書を作成します。詳細については、「Amazon Lightsail コンテナサービスの SSL/TLS 証明書の作成」を参照してください。

  9. ドメインの DNS にレコードを追加して、SSL/TLS 証明書を検証します。詳細については、「Amazon Lightsail コンテナサービスの SSL/TLS 証明書の検証」を参照してください。

  10. 有効な SSL/TLS 証明書をコンテナサービスに添付して、カスタムドメインを有効にします。詳細については、「Amazon Lightsail コンテナサービスでのカスタムドメインの有効化と管理」を参照してください。

  11. コンテナサービスの使用状況メトリクスをモニタリングします。詳細については、「Amazon Lightsail でのコンテナサービス メトリクスの表示」を参照してください。

  12. (オプション）パワースペックを垂直方向に増やし、スケールスペックを水平方向に増やして、コンテナサービスの容量をスケールします。詳細については、「Amazon Lightsail コンテナサービスの容量の変更」を参照してください。

  13. コンテナサービスを使用していない場合は、月額料金が発生しないようにコンテナサービスを削除します。詳細については、「Amazon Lightsail コンテナサービスの削除」を参照してください。