Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Tutorial: Menyebarkan aplikasi ke Amazon ECS
Dalam tutorial ini, Anda mempelajari cara menerapkan aplikasi tanpa server ke Amazon Elastic Container Service (Amazon ECS) menggunakan alur kerja, Amazon ECS, dan beberapa layanan lainnya. AWS Aplikasi yang digunakan adalah situs web Hello World sederhana yang dibangun di atas image Docker server web Apache. Tutorial memandu Anda melalui pekerjaan persiapan yang diperlukan seperti menyiapkan cluster, dan kemudian menjelaskan cara membuat alur kerja untuk membangun dan menyebarkan aplikasi.
Tip
Alih-alih mengerjakan tutorial ini, Anda dapat menggunakan cetak biru yang melakukan pengaturan Amazon ECS lengkap untuk Anda. Anda harus menggunakan API Node.js dengan AWS Fargate atau Java API dengan AWS Fargate cetak biru. Untuk informasi selengkapnya, lihat Membuat proyek dengan cetak biru.
Topik
- Prasyarat
- Langkah 1: Siapkan AWS pengguna dan AWS CloudShell
- Langkah 2: Menyebarkan aplikasi placeholder ke Amazon ECS
- Langkah 3: Buat repositori gambar Amazon ECR
- Langkah 4: Buat AWS peran
- Langkah 5: Tambahkan AWS peran ke CodeCatalyst
- Langkah 6: Buat repositori sumber
- Langkah 7: Tambahkan file sumber
- Langkah 8: Buat dan jalankan alur kerja
- Langkah 9: Buat perubahan pada file sumber Anda
- Bersihkan
Prasyarat
Sebelum Anda memulai:
-
Anda membutuhkan CodeCatalyst ruang dengan AWS akun yang terhubung. Untuk informasi selengkapnya, lihat Menciptakan ruang.
-
Di ruang Anda, Anda memerlukan CodeCatalyst proyek kosong, Mulai dari awal yang disebut:
codecatalyst-ecs-project
Untuk informasi selengkapnya, lihat Membuat proyek kosong di Amazon CodeCatalyst.
-
Dalam proyek Anda, Anda memerlukan CodeCatalyst lingkungan yang disebut:
codecatalyst-ecs-environment
Konfigurasikan lingkungan ini sebagai berikut:
-
Pilih jenis apa pun, seperti Non-produksi.
-
Hubungkan AWS akun Anda ke sana.
-
Untuk peran IAM Default, pilih peran apa pun. Anda akan menentukan peran yang berbeda nanti.
Untuk informasi selengkapnya, lihat Menyebarkan ke dalam Akun AWS dan VPC dengan lingkungan CodeCatalyst.
-
Langkah 1: Siapkan AWS pengguna dan AWS CloudShell
Langkah pertama dalam tutorial ini adalah membuat pengguna AWS IAM Identity Center, dan meluncurkan AWS CloudShell instance sebagai pengguna ini. Selama tutorial ini, CloudShell adalah komputer pengembangan Anda dan di mana Anda mengkonfigurasi AWS sumber daya dan layanan. Hapus pengguna ini setelah menyelesaikan tutorial.
catatan
Jangan gunakan pengguna root Anda untuk tutorial ini. Anda harus membuat pengguna terpisah atau Anda mungkin mengalami masalah saat melakukan tindakan di AWS Command Line Interface (CLI) nanti.
Untuk informasi selengkapnya tentang pengguna Pusat Identitas IAM dan CloudShell, lihat Panduan AWS IAM Identity Center Pengguna dan Panduan AWS CloudShell Pengguna.
Untuk membuat pengguna IAM Identity Center
Masuk ke AWS Management Console dan buka AWS IAM Identity Center konsol di https://console.aws.amazon.com/singlesignon/
. catatan
Pastikan Anda masuk menggunakan Akun AWS yang terhubung ke CodeCatalyst ruang Anda. Anda dapat memverifikasi akun mana yang terhubung dengan menavigasi ke ruang Anda dan memilih tab akun AWS. Untuk informasi selengkapnya, lihat Menciptakan ruang.
-
Pada panel navigasi, silakan pilih Pengguna, lalu pilih Tambahkan pengguna.
-
Di Nama Pengguna, masukkan:
CodeCatalystECSUser
-
Di bawah Kata Sandi, pilih Buat kata sandi satu kali yang dapat Anda bagikan dengan pengguna ini.
-
Di Alamat Email dan Konfirmasi alamat email, masukkan alamat email yang belum ada di Pusat Identitas IAM.
-
Di Nama depan dan nama belakang, masukkan:
CodeCatalystECSUser
-
Di Nama tampilan, simpan nama yang dihasilkan secara otomatis:
CodeCatalystECSUser CodeCatalystECSUser
-
Pilih Selanjutnya.
-
Pada halaman Tambahkan pengguna ke grup, pilih Berikutnya.
-
Pada halaman Tinjau dan tambahkan pengguna, tinjau informasi dan pilih Tambah pengguna.
Kotak dialog kata sandi satu kali muncul.
-
Pilih Salin lalu tempel informasi masuk, termasuk URL portal AWS akses dan kata sandi satu kali.
-
Pilih Tutup.
Untuk membuat set izin
Anda akan menetapkan izin ini disetel CodeCatalystECSUser
nanti.
-
Di panel navigasi, pilih Set izin, lalu pilih Buat set izin.
-
Pilih Set izin yang telah ditentukan sebelumnya dan kemudian pilih AdministratorAccess. Kebijakan ini memberikan izin penuh untuk semua Layanan AWS.
-
Pilih Selanjutnya.
-
Dalam nama set Izin, masukkan:
CodeCatalystECSPermissionSet
-
Pilih Selanjutnya.
-
Pada halaman Tinjau dan buat, tinjau informasi dan pilih Buat.
Untuk menetapkan izin yang disetel ke CodeCatalyst ECSUSER
-
Di panel navigasi, pilih Akun AWS, lalu pilih kotak centang di Akun AWS samping tempat Anda masuk saat ini.
-
Pilih Tetapkan pengguna atau grup.
-
Pilih tab Pengguna.
-
Pilih kotak centang di sebelah
CodeCatalystECSUser
. -
Pilih Selanjutnya.
-
Pilih kotak centang di sebelah
CodeCatalystECSPermissionSet
. -
Pilih Selanjutnya.
-
Tinjau informasi dan pilih Kirim.
Anda sekarang telah menetapkan
CodeCatalystECSUser
danCodeCatalystECSPermissionSet
untuk Anda Akun AWS, mengikat mereka bersama-sama.
Untuk keluar dan masuk kembali sebagai CodeCatalyst ECSUSER
-
Sebelum Anda keluar, pastikan Anda memiliki URL portal AWS akses dan nama pengguna dan kata sandi satu kali untuk
CodeCatalystECSUser
. Anda seharusnya menyalin informasi ini ke editor teks sebelumnya.catatan
Jika Anda tidak memiliki informasi ini, buka halaman
CodeCatalystECSUser
detail di Pusat Identitas IAM, pilih Atur ulang kata sandi, Hasilkan kata sandi satu kali [...] , dan Reset kata sandi lagi untuk menampilkan informasi di layar. -
Keluar dari AWS.
-
Rekatkan URL portal AWS akses ke bilah alamat browser Anda.
-
Masuk dengan nama pengguna dan kata sandi satu kali untuk
CodeCatalystECSUser
. -
Di Kata sandi baru, masukkan kata sandi, dan pilih Atur kata sandi baru.
Sebuah Akun AWSkotak muncul di layar.
-
Pilih Akun AWS, lalu pilih nama yang Akun AWS Anda tetapkan
CodeCatalystECSUser
pengguna dan set izin. -
Di sebelah
CodeCatalystECSPermissionSet
, pilih Konsol manajemen.AWS Management Console Muncul. Anda sekarang masuk
CodeCatalystECSUser
dengan izin yang sesuai.
Untuk meluncurkan sebuah AWS CloudShell instance
-
Seperti
CodeCatalystECSUser
, di bilah navigasi atas, pilih AWS ikon ().
Halaman utama AWS Management Console muncul.
-
Di bilah navigasi atas, pilih AWS CloudShell ikon (
).
CloudShell terbuka. Tunggu sementara CloudShell lingkungan dibuat.
catatan
Jika Anda tidak melihat CloudShell ikon, pastikan Anda berada di Wilayah yang didukung oleh CloudShell. Tutorial ini mengasumsikan Anda berada di Wilayah AS Barat (Oregon).
Untuk memverifikasi bahwa AWS CLI sudah diinstal
-
Di CloudShell terminal, masukkan:
aws --version
-
Periksa apakah ada versi yang muncul.
AWS CLI Ini sudah dikonfigurasi untuk pengguna saat ini
CodeCatalystECSUser
, jadi tidak perlu mengkonfigurasi AWS CLI kunci dan kredensyal, seperti biasanya.
Langkah 2: Menyebarkan aplikasi placeholder ke Amazon ECS
Di bagian ini, Anda secara manual menyebarkan aplikasi placeholder ke Amazon ECS. Aplikasi placeholder ini akan digantikan oleh aplikasi Hello World yang digunakan oleh alur kerja Anda. Aplikasi placeholder adalah Apache Web Server.
Untuk informasi selengkapnya tentang Amazon ECS, lihat Panduan Pengembang Layanan Kontainer Elastis Amazon.
Lengkapi serangkaian prosedur berikut untuk menyebarkan aplikasi placeholder.
Untuk membuat peran eksekusi tugas
Peran ini memberikan Amazon ECS dan AWS Fargate (Fargate) izin untuk melakukan panggilan API atas nama Anda.
-
Buat kebijakan kepercayaan:
-
Di AWS CloudShell, masukkan perintah berikut:
cat > codecatalyst-ecs-trust-policy.json
Prompt berkedip muncul di CloudShell terminal.
-
Masukkan kode berikut pada prompt:
{ "Version": "2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": "ecs-tasks.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
-
Tempatkan kursor Anda setelah braket keriting terakhir ().
}
-
Tekan
Enter
dan kemudianCtrl+d
untuk menyimpan file dan keluar dari kucing.
-
-
Buat peran eksekusi tugas:
aws iam create-role \ --role-name codecatalyst-ecs-task-execution-role \ --assume-role-policy-document file://codecatalyst-ecs-trust-policy.json
-
Lampirkan
AmazonECSTaskExecutionRolePolicy
kebijakan AWS terkelola ke peran:aws iam attach-role-policy \ --role-name codecatalyst-ecs-task-execution-role \ --policy-arn arn:aws:iam::aws:policy/service-role/AmazonECSTaskExecutionRolePolicy
-
Menampilkan detail peran:
aws iam get-role \ --role-name codecatalyst-ecs-task-execution-role
-
Perhatikan
"Arn":
nilai peran, misalnya,arn:aws:iam::111122223333:role/codecatalyst-ecs-task-execution-role
. Anda akan memerlukan Nama Sumber Daya Amazon (ARN) ini nanti.
Untuk membuat cluster Amazon ECS
Cluster ini akan berisi aplikasi placeholder Apache, dan kemudian, aplikasi Hello World.
-
Seperti
CodeCatalystECSUser
, di AWS CloudShell, buat cluster kosong:aws ecs create-cluster --cluster-name codecatalyst-ecs-cluster
-
(Opsional) Verifikasi bahwa cluster berhasil dibuat:
aws ecs list-clusters
ARN
codecatalyst-ecs-cluster
cluster akan muncul dalam daftar, menunjukkan penciptaan yang berhasil.
Untuk membuat file definisi tugas
File definisi tugas menunjukkan untuk menjalankan Apache 2.4 Web serverhttpd:2.4
) yang ditarik dari. DockerHub
-
Seperti
CodeCatalystECSUser
, di AWS CloudShell, buat file definisi tugas:cat > taskdef.json
-
Tempel kode berikut pada prompt:
{ "executionRoleArn": "
arn:aws:iam::111122223333:role/codecatalyst-ecs-task-execution-role
", "containerDefinitions": [ { "name": "codecatalyst-ecs-container", "image": "httpd:2.4", "essential": true, "portMappings": [ { "hostPort": 80, "protocol": "tcp", "containerPort": 80 } ] } ], "requiresCompatibilities": [ "FARGATE" ], "cpu": "256", "family": "codecatalyst-ecs-task-def", "memory": "512", "networkMode": "awsvpc" }Pada kode sebelumnya, ganti
arn:aws:iam: :111122223333:role/
-role codecatalyst-ecs-task-executiondengan ARN dari peran eksekusi tugas yang Anda catat. Untuk membuat peran eksekusi tugas
-
Tempatkan kursor Anda setelah braket keriting terakhir ().
}
-
Tekan
Enter
dan kemudianCtrl+d
untuk menyimpan file dan keluar dari kucing.
Untuk mendaftarkan file definisi tugas dengan Amazon ECS
-
Seperti
CodeCatalystECSUser
, dalam AWS CloudShell, daftarkan definisi tugas:aws ecs register-task-definition \ --cli-input-json file://taskdef.json
-
(Opsional) Verifikasi bahwa definisi tugas telah terdaftar:
aws ecs list-task-definitions
Definisi
codecatalyst-ecs-task-def
tugas akan muncul dalam daftar.
Untuk membuat layanan Amazon ECS
Layanan Amazon ECS menjalankan tugas (dan wadah Docker terkait) dari aplikasi placeholder Apache, dan kemudian, aplikasi Hello World.
-
Sebagai
CodeCatalystECSUser
, beralihlah ke konsol Amazon Elastic Container Service jika Anda belum melakukannya. -
Pilih cluster yang Anda buat sebelumnya,
codecatalyst-ecs-cluster
. -
Di tab Layanan, pilih Buat.
-
Di halaman Create, lakukan hal berikut:
-
Simpan semua pengaturan default kecuali yang tercantum berikutnya.
-
Untuk jenis Peluncuran, pilih FARGATE.
-
Di bawah Definisi tugas, dalam daftar drop-down Keluarga, pilih:
codecatalyst-ecs-task-def
-
Untuk nama Layanan, masukkan:
codecatalyst-ecs-service
-
Untuk tugas yang diinginkan, masukkan:
3
Dalam tutorial ini, setiap tugas meluncurkan satu wadah Docker.
-
Perluas bagian Jaringan.
-
Untuk VPC, pilih VPC apa saja.
-
Untuk Subnet, pilih subnet apa saja.
catatan
Hanya tentukan satu subnet. Itu saja yang diperlukan untuk tutorial ini.
catatan
Jika Anda tidak memiliki VPC dan subnet, buatlah. Lihat Membuat VPC, dan Membuat subnet di VPC Anda di Panduan Pengguna Amazon VPC.
-
Untuk grup Keamanan, pilih Buat grup keamanan baru, lalu lakukan hal berikut:
-
Untuk nama grup Keamanan, masukkan:
codecatalyst-ecs-security-group
-
Untuk deskripsi grup Keamanan, masukkan:
CodeCatalyst ECS security group
-
Pilih Tambahkan aturan. Untuk Type, pilih HTTP, dan untuk Source, pilih Anywhere.
-
-
Di bagian bawah, pilih Buat.
-
Tunggu sementara layanan dibuat. Ini mungkin memakan waktu beberapa menit.
-
-
Pilih tab Tugas, lalu pilih tombol segarkan. Verifikasi bahwa ketiga tugas tersebut memiliki kolom Status Terakhir yang disetel ke Running.
(Opsional) Untuk memverifikasi bahwa aplikasi placeholder Apache Anda sedang berjalan
-
Di tab Tugas, pilih salah satu dari tiga tugas.
-
Di bidang IP Publik, pilih alamat terbuka.
Sebuah
It Works!
halaman muncul. Ini menunjukkan bahwa layanan Amazon ECS berhasil memulai tugas yang meluncurkan wadah Docker dengan gambar Apache.Pada titik ini dalam tutorial, Anda telah secara manual menerapkan klaster Amazon ECS, layanan, dan definisi tugas, serta aplikasi placeholder Apache. Dengan semua item ini di tempat, Anda sekarang siap untuk membuat alur kerja yang akan menggantikan aplikasi placeholder Apache dengan aplikasi Hello World tutorial.
Langkah 3: Buat repositori gambar Amazon ECR
Di bagian ini, Anda membuat repositori gambar pribadi di Amazon Elastic Container Registry (Amazon ECR) Registry ECR). Repositori ini menyimpan gambar Docker tutorial yang akan menggantikan gambar placeholder Apache yang Anda gunakan sebelumnya.
Untuk informasi selengkapnya tentang Amazon ECR, lihat Panduan Pengguna Amazon Elastic Container Registry.
Untuk membuat repositori gambar di Amazon ECR
-
Seperti
CodeCatalystECSUser
, di AWS CloudShell, buat repositori kosong di Amazon ECR:aws ecr create-repository --repository-name codecatalyst-ecs-image-repo
-
Tampilkan detail repositori Amazon ECR:
aws ecr describe-repositories \ --repository-names codecatalyst-ecs-image-repo
-
Perhatikan
“repositoryUri”:
nilainya, misalnya,111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-ecs-image-repo
.Anda membutuhkannya nanti saat menambahkan repositori ke alur kerja Anda.
Langkah 4: Buat AWS peran
Di bagian ini, Anda membuat peran AWS IAM yang dibutuhkan CodeCatalyst alur kerja Anda agar berfungsi. Peran ini adalah:
-
Peran build - Memberikan izin tindakan CodeCatalyst build (dalam alur kerja) untuk mengakses AWS akun Anda dan menulis ke Amazon ECR dan Amazon EC2.
-
Menyebarkan peran - Memberikan izin tindakan CodeCatalyst Deploy ke ECS (dalam alur kerja) untuk mengakses akun Anda AWS , Amazon ECS, dan beberapa layanan lainnya. AWS
Untuk informasi selengkapnya tentang peran IAM, lihat peran IAM di AWS Identity and Access Management Panduan Pengguna.
catatan
Untuk menghemat waktu, Anda dapat membuat satu peran, yang disebut CodeCatalystWorkflowDevelopmentRole-
peran, alih-alih dua peran yang tercantum sebelumnya. Untuk informasi selengkapnya, lihat Membuat CodeCatalystWorkflowDevelopmentRole-spaceNameperan untuk akun dan ruang Anda. Pahami bahwa spaceName
CodeCatalystWorkflowDevelopmentRole-
peran tersebut memiliki izin yang sangat luas yang dapat menimbulkan risiko keamanan. Kami menyarankan Anda hanya menggunakan peran ini dalam tutorial dan skenario di mana keamanan kurang menjadi perhatian. Tutorial ini mengasumsikan Anda membuat dua peran yang tercantum sebelumnya.spaceName
Untuk membuat peran build dan deploy, Anda dapat menggunakan peran AWS Management Console atau. AWS CLI
Langkah 5: Tambahkan AWS peran ke CodeCatalyst
Pada langkah ini, Anda menambahkan build role (codecatalyst-ecs-build-role
) dan deploy role (codecatalyst-ecs-deploy-role
) ke koneksi CodeCatalyst akun di ruang Anda.
Untuk menambahkan peran build dan deploy ke koneksi akun
-
Masuk CodeCatalyst, navigasikan ke ruang Anda.
-
Pilih AWS akun. Daftar koneksi akun muncul.
-
Pilih koneksi akun yang mewakili AWS akun tempat Anda membuat peran build dan deploy.
-
Pilih Kelola peran dari konsol AWS manajemen.
Peran Tambahkan IAM ke halaman CodeCatalyst ruang Amazon muncul. Anda mungkin perlu masuk untuk mengakses halaman.
-
Pilih Tambahkan peran yang sudah Anda buat di IAM.
Daftar drop-down muncul. Daftar ini menampilkan semua peran IAM dengan kebijakan kepercayaan yang mencakup prinsip
codecatalyst-runner.amazonaws.com
dancodecatalyst.amazonaws.com
layanan. -
Dalam daftar drop-down, pilih
codecatalyst-ecs-build-role
, dan pilih Tambah peran.catatan
Jika Anda melihat
The security token included in the request is invalid
, itu mungkin karena Anda tidak memiliki izin yang tepat. Untuk memperbaiki masalah ini, keluar dari AWS sebagai masuk kembali dengan AWS akun yang Anda gunakan saat membuat CodeCatalyst ruang. -
Pilih Tambahkan peran IAM, pilih Tambahkan peran yang ada yang telah Anda buat di IAM, dan dalam daftar drop-down, pilih.
codecatalyst-ecs-deploy-role
Pilih Tambahkan peran.Anda sekarang telah menambahkan peran build dan deploy ke ruang Anda.
-
Salin nilai nama CodeCatalyst tampilan Amazon. Anda akan membutuhkan nilai ini nanti, saat membuat alur kerja Anda.
Langkah 6: Buat repositori sumber
Pada langkah ini, Anda membuat repositori sumber di. CodeCatalyst Repositori ini menyimpan file sumber tutorial, seperti file definisi tugas.
Untuk informasi selengkapnya tentang repositori sumber, lihat. Membuat repositori sumber
Untuk membuat repositori sumber
Buka CodeCatalyst konsol di https://codecatalyst.aws/
. -
Arahkan ke proyek Anda,
codecatalyst-ecs-project
. -
Di panel navigasi, pilih Kode, lalu pilih Repositori sumber.
-
Pilih Tambahkan repositori, lalu pilih Buat repositori.
-
Dalam nama Repositori, masukkan:
codecatalyst-ecs-source-repository
-
Pilih Buat.
Langkah 7: Tambahkan file sumber
Di bagian ini, Anda menambahkan file sumber Hello World ke CodeCatalyst repositori Anda,. codecatalyst-ecs-source-repository
Mereka terdiri dari:
-
index.html
File - Menampilkan pesan Hello World di browser. -
A Dockerfile - Menjelaskan gambar dasar yang akan digunakan untuk image Docker Anda dan perintah Docker untuk menerapkannya.
-
taskdef.json
File - Mendefinisikan image Docker yang akan digunakan saat meluncurkan tugas ke cluster Anda.
Struktur folder adalah sebagai berikut:
. |— public-html | |— index.html |— Dockerfile |— taskdef.json
catatan
Petunjuk berikut menunjukkan cara menambahkan file menggunakan CodeCatalyst konsol tetapi Anda dapat menggunakan Git jika Anda mau. Lihat perinciannya di Mengkloning repositori sumber.
index.html
index.html
File menampilkan pesan Hello World di browser.
Untuk menambahkan file index.html
-
Di CodeCatalyst konsol, buka repositori sumber Anda,.
codecatalyst-ecs-source-repository
-
Di File, pilih Buat file.
-
Untuk nama File, masukkan:
public-html/index.html
penting
Pastikan untuk menyertakan
public-html/
awalan untuk membuat folder dengan nama yang sama.index.html
Diharapkan ada di folder ini. -
Di kotak teks, masukkan kode berikut:
<html> <head> <title>Hello World</title> <style> body { background-color: black; text-align: center; color: white; font-family: Arial, Helvetica, sans-serif; } </style> </head> <body> <h1>Hello World</h1> </body> </html>
-
Pilih Komit, lalu pilih Komit lagi.
Ditambahkan ke repositori Anda dalam folder.
index.html
public-html
Dockerfile
Dockerfile menjelaskan image Docker dasar yang akan digunakan dan perintah Docker untuk diterapkan padanya. Untuk informasi selengkapnya tentang Dockerfile, lihat Referensi Dockerfile
Dockerfile yang ditentukan di sini menunjukkan untuk menggunakan image dasar Apache 2.4 (). httpd
Ini juga mencakup instruksi untuk menyalin file sumber yang dipanggil index.html
ke folder di server Apache yang melayani halaman web. EXPOSE
Instruksi di Dockerfile memberi tahu Docker bahwa wadah mendengarkan pada port 80.
Untuk menambahkan Dockerfile
-
Di repositori sumber Anda, pilih Buat file.
-
Untuk nama File, masukkan:
Dockerfile
Jangan sertakan ekstensi file.
penting
Dockerfile harus berada di folder root repositori Anda.
Docker build
Perintah alur kerja mengharapkannya ada di sana. -
Di kotak teks, masukkan kode berikut:
FROM httpd:2.4 COPY ./public-html/index.html /usr/local/apache2/htdocs/index.html EXPOSE 80
-
Pilih Komit, lalu pilih Komit lagi.
Dockerfile ditambahkan ke repositori Anda.
taskdef.json
taskdef.json
File yang Anda tambahkan pada langkah ini sama dengan yang sudah Anda tentukan Langkah 2: Menyebarkan aplikasi placeholder ke Amazon ECS dengan perbedaan berikut:
Alih-alih menentukan nama gambar Docker yang di-hardcode di image:
bidang (httpd:2.4
), definisi tugas di sini menggunakan beberapa variabel untuk menunjukkan gambar: dan. $REPOSITORY_URI
$IMAGE_TAG
Variabel-variabel ini akan diganti dengan nilai nyata yang dihasilkan oleh aksi build alur kerja saat Anda menjalankan alur kerja di langkah selanjutnya.
Untuk detail tentang parameter definisi tugas, lihat Parameter definisi tugas di Panduan Pengembang Layanan Kontainer Elastis Amazon.
Untuk menambahkan file taskdef.json
-
Di repositori sumber Anda, pilih Buat file.
-
Untuk nama File, masukkan:
taskdef.json
-
Di kotak teks, masukkan kode berikut:
{ "executionRoleArn": "
arn:aws:iam::account_ID:role/codecatalyst-ecs-task-execution-role
", "containerDefinitions": [ { "name": "codecatalyst-ecs-container", # The $REPOSITORY_URI and $IMAGE_TAG variables will be replaced # by the workflow at build time (see the build action in the # workflow) "image": $REPOSITORY_URI:$IMAGE_TAG, "essential": true, "portMappings": [ { "hostPort": 80, "protocol": "tcp", "containerPort": 80 } ] } ], "requiresCompatibilities": [ "FARGATE" ], "networkMode": "awsvpc", "cpu": "256", "memory": "512", "family": "codecatalyst-ecs-task-def" }Pada kode sebelumnya, ganti
arn:aws:iam: :account_id:peran/ -peran codecatalyst-ecs-task-execution
dengan ARN dari peran eksekusi tugas yang Anda catat. Untuk membuat peran eksekusi tugas
-
Pilih Komit, lalu pilih Komit lagi.
taskdef.json
File ditambahkan ke repositori Anda.
Langkah 8: Buat dan jalankan alur kerja
Pada langkah ini, Anda membuat alur kerja yang mengambil file sumber Anda, membuatnya menjadi image Docker, dan kemudian menyebarkan gambar ke cluster Amazon ECS Anda. Deployment ini menggantikan aplikasi placeholder Apache yang ada.
Alur kerja terdiri dari blok bangunan berikut yang berjalan secara berurutan:
-
Pemicu - Pemicu ini memulai alur kerja yang dijalankan secara otomatis saat Anda mendorong perubahan ke repositori sumber Anda. Untuk informasi lebih lanjut tentang menggunakan pemicu, lihat Memulai alur kerja berjalan secara otomatis dengan pemicu.
-
Tindakan build (
BuildBackend
) — Pada pemicu, aksi membangun image Docker menggunakan Dockerfile dan mendorong gambar ke Amazon ECR. Tindakan build juga memperbaruitaskdef.json
dengan nilaiimage
bidang yang benar, dan kemudian membuat artefak keluaran file ini. Artefak ini digunakan sebagai masukan untuk tindakan penyebaran, yang berikutnya.Untuk informasi selengkapnya tentang tindakan build, lihatMembangun dengan alur kerja.
-
Tindakan penerapan (
DeployToECS
) — Setelah menyelesaikan aksi build, tindakan deploy mencari artefak keluaran yang dihasilkan oleh build action (TaskDefArtifact
), menemukantaskdef.json
bagian dalamnya, dan mendaftarkannya dengan layanan Amazon ECS Anda. Layanan kemudian mengikuti instruksi dalamtaskdef.json
file untuk menjalankan tiga tugas Amazon ECS — dan container Hello World Docker terkait — di dalam cluster Amazon ECS Anda.
Untuk membuat alur kerja
-
Di CodeCatalyst konsol, di panel navigasi, pilih CI/CD, lalu pilih Alur kerja.
-
Pilih Buat alur kerja.
-
Untuk repositori Sumber, pilih.
codecatalyst-ecs-source-repository
-
Untuk Cabang, pilih
main
. -
Pilih Buat.
Hapus kode sampel YAMAL.
-
Tambahkan kode YAML berikut:
catatan
Dalam kode YAMAL berikut, Anda dapat menghilangkan
Connections:
bagian jika Anda mau. Jika Anda menghilangkan bagian ini, Anda harus memastikan bahwa peran yang ditentukan dalam bidang peran IAM default di lingkungan Anda mencakup izin dan kebijakan kepercayaan dari kedua peran yang dijelaskan. Langkah 5: Tambahkan AWS peran ke CodeCatalyst Untuk informasi selengkapnya tentang menyiapkan lingkungan dengan peran IAM default, lihatPembuatan lingkungan.Name: codecatalyst-ecs-workflow SchemaVersion: 1.0 Triggers: - Type: PUSH Branches: - main Actions: BuildBackend: Identifier: aws/build@v1 Environment: Name:
codecatalyst-ecs-environment
Connections: - Name:codecatalyst-account-connection
Role:codecatalyst-ecs-build-role
Inputs: Sources: - WorkflowSource Variables: - Name: REPOSITORY_URI Value:111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-ecs-image-repo
- Name: IMAGE_TAG Value: ${WorkflowSource.CommitId} Configuration: Steps: #pre_build: - Run: echo Logging in to Amazon ECR... - Run: aws --version - Run: aws ecr get-login-password --regionus-west-2
| docker login --username AWS --password-stdin111122223333.dkr.ecr.us-west-2.amazonaws.com
#build: - Run: echo Build started on `date` - Run: echo Building the Docker image... - Run: docker build -t $REPOSITORY_URI:latest . - Run: docker tag $REPOSITORY_URI:latest $REPOSITORY_URI:$IMAGE_TAG #post_build: - Run: echo Build completed on `date` - Run: echo Pushing the Docker images... - Run: docker push $REPOSITORY_URI:latest - Run: docker push $REPOSITORY_URI:$IMAGE_TAG # Replace the variables in taskdef.json - Run: find taskdef.json -type f | xargs sed -i "s|\$REPOSITORY_URI|$REPOSITORY_URI|g" - Run: find taskdef.json -type f | xargs sed -i "s|\$IMAGE_TAG|$IMAGE_TAG|g" - Run: cat taskdef.json # The output artifact will be a zip file that contains a task definition file. Outputs: Artifacts: - Name: TaskDefArtifact Files: - taskdef.json DeployToECS: DependsOn: - BuildBackend Identifier: aws/ecs-deploy@v1 Environment: Name:codecatalyst-ecs-environment
Connections: - Name:codecatalyst-account-connection
Role:codecatalyst-ecs-deploy-role
Inputs: Sources: [] Artifacts: - TaskDefArtifact Configuration: region:us-west-2
cluster: codecatalyst-ecs-cluster service: codecatalyst-ecs-service task-definition: taskdef.jsonPada kode sebelumnya, ganti:
-
Kedua contoh
codecatalyst-ecs-environment
dengan nama lingkungan yang Anda buat. Prasyarat -
Kedua contoh
codecatalyst-account-connection
dengan nama tampilan koneksi akun Anda. Nama tampilan mungkin nomor. Untuk informasi selengkapnya, lihat Langkah 5: Tambahkan AWS peran ke CodeCatalyst. -
codecatalyst-ecs-build-role
dengan nama peran build yang Anda buatLangkah 4: Buat AWS peran. -
111122223333.dkr. ecr.us-west-2.amazonaws.com/codecatalyst-ecs-image-repo
(di propertiValue:
) dengan URI repositori Amazon ECR yang Anda buat. Langkah 3: Buat repositori gambar Amazon ECR -
111122223333.dkr. ecr.us-west-2.amazonaws.com
(dalam perintahRun: aws ecr
) dengan URI repositori Amazon ECR tanpa akhiran gambar ()./codecatalyst-ecs-image-repo
-
codecatalyst-ecs-deploy-role
dengan nama peran penerapan yang Anda buat. Langkah 4: Buat AWS peran -
Kedua instance
us-west-2
dengan kode Wilayah Anda. AWS Untuk daftar kode Region, lihat Titik akhir Regional di. Referensi Umum AWS
catatan
Jika Anda memutuskan untuk tidak membuat peran build dan deploy, ganti
codecatalyst-ecs-build-role
dancodecatalyst-ecs-deploy-role
dengan namaCodeCatalystWorkflowDevelopmentRole-
peran tersebut. Untuk informasi selengkapnya tentang peran ini, silakan lihat Langkah 4: Buat AWS peran.spaceName
Tip
Alih-alih menggunakan
sed
perintahfind
dan yang ditampilkan dalam kode alur kerja sebelumnya untuk memperbarui repositori dan nama gambar, Anda dapat menggunakan tindakan definisi tugas Render Amazon ECS untuk tujuan ini. Untuk informasi selengkapnya, lihat Memodifikasi file definisi tugas Amazon ECS menggunakan alur kerja. -
-
(Opsional) Pilih Validasi untuk memastikan bahwa kode YAMAL valid sebelum melakukan.
-
Pilih Terapkan.
-
Dalam kotak dialog Commit workflow, masukkan yang berikut ini:
-
Untuk pesan Commit, hapus teks dan masukkan:
Add first workflow
-
Untuk Repositori, pilih.
codecatalyst-ecs-source-repository
-
Untuk nama cabang, pilih main.
-
Pilih Terapkan.
Anda sekarang telah membuat alur kerja. Jalankan alur kerja dimulai secara otomatis karena pemicu yang ditentukan di bagian atas alur kerja. Khususnya, ketika Anda melakukan (dan mendorong)
workflow.yaml
file ke repositori sumber Anda, pemicu memulai alur kerja dijalankan. -
Untuk melihat alur kerja, jalankan kemajuan
-
Di panel navigasi CodeCatalyst konsol, pilih CI/CD, lalu pilih Alur kerja.
-
Pilih alur kerja yang baru saja Anda buat,
codecatalyst-ecs-workflow
. -
Pilih BuildBackenduntuk melihat kemajuan pembangunan.
-
Pilih DeployToECS untuk melihat kemajuan penerapan.
Untuk informasi selengkapnya tentang melihat detail run, lihatMelihat alur kerja menjalankan status dan detail.
Untuk memverifikasi penyebaran
-
Buka konsol klasik Amazon ECS di https://console.aws.amazon.com/ecs/.
-
Pilih cluster Anda,
codecatalyst-ecs-cluster
. -
Pilih tab Tugas.
-
Pilih salah satu dari tiga tugas.
-
Di bidang IP Publik, pilih alamat terbuka.
Halaman “Hello World” muncul di browser, menunjukkan bahwa layanan Amazon ECS berhasil menyebarkan aplikasi Anda.
Langkah 9: Buat perubahan pada file sumber Anda
Di bagian ini, Anda membuat perubahan pada index.html
file di repositori sumber Anda. Perubahan ini menyebabkan alur kerja membuat image Docker baru, menandainya dengan ID komit, mendorongnya ke Amazon ECR, dan menerapkannya ke Amazon ECS.
Untuk mengubah index.html
-
Di CodeCatalyst konsol, di panel navigasi, pilih Kode, lalu pilih repositori Sumber, lalu pilih repositori Anda,.
codecatalyst-ecs-source-repository
-
Pilih
public-html
, lalu pilihindex.html
.Isi
index.html
muncul. -
Pilih Edit.
-
Pada baris 14, ubah
Hello World
teks menjadiTutorial complete!
. -
Pilih Komit, lalu pilih Komit lagi.
Komit menyebabkan alur kerja baru dijalankan.
-
(Opsional) Buka halaman utama repositori sumber Anda, pilih Lihat komit, lalu catat ID komit untuk perubahan tersebut.
index.html
-
Perhatikan kemajuan penerapan:
-
Di panel navigasi, pilih CI/CD, lalu pilih Alur kerja.
-
Pilih
codecatalyst-ecs-workflow
untuk melihat proses terbaru. -
Pilih BuildBackend, dan DeployToECS untuk melihat alur kerja berjalan kemajuan.
-
-
Verifikasi bahwa aplikasi Anda telah diperbarui, sebagai berikut:
-
Buka konsol klasik Amazon ECS di https://console.aws.amazon.com/ecs/.
-
Pilih cluster Anda,
codecatalyst-ecs-cluster
. -
Pilih tab Tugas.
-
Pilih salah satu dari tiga tugas.
-
Di bidang IP Publik, pilih alamat terbuka.
Sebuah
Tutorial complete!
halaman muncul.
-
-
(Opsional) Di AWS, alihkan ke konsol Amazon ECR dan verifikasi bahwa image Docker baru ditandai dengan ID komit dari langkah 6.
Bersihkan
Bersihkan file dan layanan yang digunakan dalam tutorial ini untuk menghindari biaya untuk mereka.
Dalam AWS Management Console, bersihkan dalam urutan ini:
-
Di Amazon ECS, lakukan hal berikut:
-
Hapus
codecatalyst-ecs-service
. -
Hapus
codecatalyst-ecs-cluster
. -
Deregister
codecatalyst-ecs-task-definition
.
-
-
Di Amazon ECR, hapus
codecatalyst-ecs-image-repo
. -
Di Amazon EC2, hapus.
codecatalyst-ecs-security-group
-
Di Pusat Identitas IAM, hapus:
-
CodeCatalystECSUser
-
CodeCatalystECSPermissionSet
-
Di CodeCatalyst konsol, bersihkan sebagai berikut:
-
Hapus
codecatalyst-ecs-workflow
. -
Hapus
codecatalyst-ecs-environment
. -
Hapus
codecatalyst-ecs-source-repository
. -
Hapus
codecatalyst-ecs-project
.
Dalam tutorial ini, Anda mempelajari cara menerapkan aplikasi ke layanan Amazon ECS menggunakan CodeCatalyst alur kerja dan tindakan Deploy ke Amazon ECS.