AWSコパイロットを使用して、Amazon ECS の開始方法
AWSAmazon ECS アプリケーションをデプロイしてコパイロットを使用して、Amazon ECS の使用を開始する
前提条件
開始する前に、以下の前提条件を満たしていることを確認してください。
-
AWS アカウントをセットアップします。詳細については、「Amazon ECS を使用するようにセットアップする」を参照してください。
-
AWSコパイロット CLIのインストール。現在、リリースは Linux および macOS システムをサポートしています。詳細については、「AWS Copilot CLI のインストール」を参照してください。
-
AWS CLI をインストールして設定します。詳細については、「AWS コマンドラインインターフェイス」を参照してください。
-
aws configure
を実行して、AWSコパイロット CLI がアプリケーションとサービスの管理に使用するデフォルトプロファイルを設定します。 -
Docker のインストールと実行 詳細については、「Docker の開始方法
」を参照してください。
1 つのコマンドを使用してアプリケーションをデプロイする
起動する前に、AWS コマンドラインツールがインストールされており、aws configure
が実行済みであることを確認してください。
次のコマンドを使用して、アプリケーションをデプロイします。
git clone https://github.com/aws-samples/amazon-ecs-cli-sample-app.git demo-app && \ cd demo-app && \ copilot init --app
demo
\ --nameapi
\ --type'Load Balanced Web Service'
\ --dockerfile'./Dockerfile'
\ --port80
\ --deploy
アプリケーションをステップバイステップでデプロイする
ステップ 1: 認証情報を設定する
aws configure
を実行して、AWSコパイロット CLI がアプリケーションとサービスの管理に使用するデフォルトプロファイルを設定します。
aws configure
ステップ 2: デモアプリのクローンを作成する
単純なフラスコアプリケーションと Dockerfile のクローンを作成します。
git clone https://github.com/aws-samples/amazon-ecs-cli-sample-app.git demo-app
ステップ 3: アプリケーションをセットアップする
-
demo-app ディレクトリ内から、
init
コマンドを実行します。Windows ユーザーの場合は、ダウンロードした
copilot.exe
ファイルを含むフォルダからinit
コマンドを実行します。copilot init
AWSコパイロット では、次のステップから始めて、一連の端末プロンプトを使用して、最初のアプリケーションとサービスのセットアップを順を追って説明します。AWS コパイロットすでにを使用してアプリケーションをデプロイしている場合は、アプリケーション名のリストからアプリケーションを選択するように求められます。
-
アプリケーションに名前を付ける
What would you like to name your application? [? for help]
Enter
.demo
ステップ 4:「デモ」アプリケーションで ECS サービスをセットアップする
-
サービスタイプを選択するよう求められます。小さな API を提供するシンプルな Flask アプリケーションを構築しています。
Which service type best represents your service's architecture? [Use arrows to move, type to filter, ? for more help] > Load Balanced Web Service Backend Service Scheduled Job
Choose
Load Balanced Web Service
-
サービスの名前を指定します。
What do you want to name this Load Balanced Web Service? [? for help]
サービスの名前の場合、Enter
。api
-
ドッカーファイルを選択します。
Which Dockerfile would you like to use for api? [Use arrows to move, type to filter, ? for more help] > ./Dockerfile Use an existing image instead
Choose
.Dockerfile
Windows ユーザーの場合は、Dockerfile へのパスを
demo-app folder
(*`...\demo-app\Dockerfile`*\.) に入力します。 -
ポートを定義します。
Which port do you want customer traffic sent to? [? for help] (80)
Enter
、またはデフォルトを受け入れます。80
-
作成中のアプリケーションリソースを示すログが見られます。
Creating the infrastructure to manage services under application demo.
-
アプリケーションリソースが作成されたら、テスト環境をデプロイします。
Would you like to deploy a test environment? [? for help] (y/N)
Enter
.y
Proposing infrastructure changes for the test environment.
-
アプリケーションデプロイのステータスを示すログが見られます。
Note: It's best to run this command in the root of your Git repository. Welcome to the Copilot CLI! We're going to walk you through some questions to help you get set up with an application on ECS. An application is a collection of containerized services that operate together. Use existing application:
No
Application name:demo
Workload type:Load Balanced Web Service
Service name:api
Dockerfile:./Dockerfile
no EXPOSE statements in Dockerfile ./Dockerfile Port:80
Ok great, we'll set up aLoad Balanced Web Service
namedapi
in applicationdemo
listening on port80
. ✔ Created the infrastructure to manage services under applicationdemo
. ✔ Wrote the manifest for serviceapi
at copilot/api
/manifest.yml Your manifest contains configurations like your container size and port (:80). ✔ Created ECR repositories for serviceapi
. All right, you're all set for local development. Deploy: Yes ✔ Created the infrastructure for the test environment. - Virtual private cloud on 2 availability zones to hold your services [Complete] - Virtual private cloud on 2 availability zones to hold your services [Complete] - Internet gateway to connect the network to the internet [Complete] - Public subnets for internet facing services [Complete] - Private subnets for services that can't be reached from the internet [Complete] - Routing tables for services to talk with each other [Complete] - ECS Cluster to hold your services [Complete] ✔ Linked accountaws_account_id
and regionregion
to applicationdemo
. ✔ Created environment test in regionregion
under applicationdemo
. Environment test is already on the latest version v1.0.0, skip upgrade. [+] Building 0.8s (7/7) FINISHED => [internal] load .dockerignore 0.1s => => transferring context: 2B 0.0s => [internal] load build definition from Dockerfile 0.0s => => transferring dockerfile: 37B 0.0s => [internal] load metadata for docker.io/library/nginx:latest 0.7s => [internal] load build context 0.0s => => transferring context: 32B 0.0s => [1/2] FROM docker.io/library/nginx@sha256:aeade65e99e5d5e7ce162833636f692354c227ff438556e5f3ed0335b7cc2f1b 0.0s => CACHED [2/2] COPY index.html /usr/share/nginx/html 0.0s => exporting to image 0.0s => => exporting layers 0.0s => => writing image sha256:3ee02fd4c0f67d7bd808ed7fc73263880649834cbb05d5ca62380f539f4884c4 0.0s => => naming toaws_account_id
.dkr.ecr.region
.amazonaws.com/demo
/api
:cee7709 0.0s WARNING! Your password will be stored unencrypted in /home/user/.docker/config.json. Configure a credential helper to remove this warning. See https://docs.docker.com/engine/reference/commandline/login/#credentials-store Login Succeeded The push refers to repository [aws_account_id
.dkr.ecr.region
.amazonaws.com/demo
/api
] 592a5c0c47f1: Pushed 6c7de695ede3: Pushed 2f4accd375d9: Pushed ffc9b21953f4: Pushed cee7709: digest: sha_digest ✔ Deployed api, you can access it at http://demo-Publi-1OQ8VMS2VC2WG-561733989.region
.elb.amazonaws.com.
ステップ 5: アプリケーションが実行されていることを検証する
次のコマンドを使用して、アプリケーションのステータスを表示します。
AWS コパイロットのアプリケーションを一覧を表示します。
copilot app ls
アプリケーション内の環境およびサービスに関する情報を表示します。
copilot app show
環境に関する情報を表示します。
copilot env ls
エンドポイント、キャパシティー、関連リソースなど、サービスに関する情報を表示します。
copilot svc show
アプリケーション内のすべてのサービスのリスト。
copilot svc ls
デプロイされたサービスのログを表示します。
copilot svc logs
サービスのステータスを表示する
copilot svc status
使用可能なコマンドとオプションを一覧表示します。
copilot --help
copilot init --help
ステップ 6。CI/CD パイプラインの作成方法を学ぶ
AWS コパイロットを使用して CI/CD パイプラインと git ワークフローを完全に自動化する方法についての詳細は、「ECSワークショップ
ステップ 7: クリーンアップする
次のコマンドを実行して、すべてのリソースを削除およびクリーンアップします。
copilot app delete