

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Pelajari cara membuat tugas untuk Instans Terkelola Amazon ECS
<a name="getting-started-managed-instances"></a>

Pelajari cara menggunakan Amazon ECS dengan Instans Terkelola Amazon ECS untuk menjalankan aplikasi kontainer.

## Prasyarat
<a name="getting-started-prerequisites"></a>

 Selesaikan yang berikut ini sebelum Anda memulai tutorial: 
+ Anda telah menyelesaikan langkah-langkah di [Mengatur untuk menggunakan Amazon ECS.](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/get-set-up-for-amazon-ecs.html)
+ Langkah-langkah di [Siapkan untuk menggunakan Amazon ECS](get-set-up-for-amazon-ecs.md) telah diselesaikan.
+ Anda memiliki peran IAM yang diperlukan untuk Instans Terkelola Amazon ECS. Hal ini mencakup:
  + Peran infrastruktur - Memungkinkan Amazon ECS melakukan panggilan ke AWS layanan atas nama Anda untuk mengelola infrastruktur Instans Terkelola Amazon ECS.

    Untuk informasi selengkapnya, lihat [Peran IAM Infrastruktur Amazon ECS](infrastructure_IAM_role.md).
  + Profil instans - Menyediakan izin untuk agen penampung Amazon ECS dan daemon Docker yang berjalan pada instance terkelola.

    Nama peran instance harus disertakan `ecsInstanceRole` sebagai awalan agar sesuai dengan `iam:PassRole` tindakan dalam peran infrastruktur. 

    Untuk informasi selengkapnya, lihat [Profil instans Instans Terkelola Amazon ECS](managed-instances-instance-profile.md).
+ Anda memiliki VPC dan grup keamanan yang dibuat untuk digunakan. Tutorial ini menggunakan gambar kontainer yang dihosting di Amazon ECR Public sehingga instans Anda harus memiliki akses internet. Untuk memberikan instance Anda rute ke internet, gunakan salah satu opsi berikut:
  + Gunakan subnet privat dengan gateway NAT yang memiliki alamat IP elastis.
  + Gunakan subnet publik dan tetapkan alamat IP publik ke instance.

  Untuk informasi selengkapnya, lihat [Buat virtual private cloud](get-set-up-for-amazon-ecs.md#create-a-vpc).

  Untuk informasi tentang grup dan aturan keamanan, lihat [Grup keamanan default untuk aturan Anda VPCs](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html#DefaultSecurityGroup) [dan Contoh](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html#security-group-rule-examples) di *Panduan Pengguna Amazon Virtual Private Cloud*.
+ (Opsional) AWS CloudShell adalah alat yang memberi pelanggan baris perintah tanpa perlu membuat instance EC2 mereka sendiri. Untuk informasi lebih lanjut, lihat [Apa itu AWS CloudShell?](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) dalam *AWS CloudShell User Guide*.

## Langkah 1: Buat cluster
<a name="getting-started-step1"></a>

1. Buka konsol Amazon ECS di [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. Dari bilah navigasi, pilih Wilayah untuk digunakan.

1. Di panel navigasi, pilih **Klaster**.

1. Pada halaman **Klaster**, pilih **Buat klaster**.

1. Di bawah **konfigurasi Cluster****, untuk nama Cluster**, masukkan nama unik untuk klaster Anda.

1. Di bawah **Infrastruktur**, pilih **Fargate dan Managed EC2**.

1. Konfigurasikan setelan Instans Terkelola:

   1. Untuk **peran Infrastruktur**, pilih peran IAM yang Anda buat untuk manajemen infrastruktur Instans Terkelola.

   1. Untuk **profil Instance**, pilih yang `ecsInstanceRole` Anda buat.

   1. Untuk **atribut Instance**, pilih **Gunakan default ECS**.

1. Di bawah **Jaringan**, konfigurasikan VPC dan subnet untuk Instans Terkelola Anda:

   1. Untuk **VPC, pilih VPC** yang menghosting Instans Terkelola.

   1. Untuk **Subnet**, pilih satu atau beberapa subnet tempat Instans Terkelola Anda akan diluncurkan.

   1. Untuk **Grup keamanan**, pilih satu atau beberapa grup keamanan.

1. (Opsional) Untuk menambahkan tag ke klaster Anda, perluas **Tag**, lalu konfigurasikan tag Anda.

1. Pilih **Buat**.

## Langkah 2: Buat definisi tugas
<a name="getting-started-step2"></a>

Definisi tugas adalah cetak biru untuk aplikasi Anda. Setiap kali Anda meluncurkan tugas di Amazon ECS, Anda menentukan definisi tugas. Layanan kemudian tahu citra Docker mana yang digunakan untuk kontainer, berapa banyak kontainer untuk digunakan dalam tugas, dan alokasi sumber daya untuk setiap kontainer. Ikuti langkah-langkah ini untuk membuat definisi tugas:

1. Di panel navigasi, pilih **Ketentuan Tugas**.

1. Pilih **Buat definisi tugas baru**, **Buat definisi tugas baru dengan JSON**.

1. Salin dan tempel JSON berikut ke editor, ganti JSON yang sudah terisi sebelumnya:

   Ganti **account-id** dengan ID AWS akun Anda dan **region** dengan Wilayah yang Anda gunakan.

   ```
   {
     "family": "managed-instance-tutorial",
     "networkMode": "awsvpc",
     "executionRoleArn": "arn:aws:iam::account-id:role/ecsTaskExecutionRole",
     "containerDefinitions": [
       {
         "name": "sample-app",
         "image": "public.ecr.aws/docker/library/httpd:latest",
         "essential": true,
         "portMappings": [
           {
             "containerPort": 80,
             "hostPort": 80,
             "protocol": "tcp"
           }
         ],
         "logConfiguration": {
           "logDriver": "awslogs",
           "options": {
             "awslogs-group": "/ecs/managed-instance-tutorial",
             "awslogs-region": "region",
             "awslogs-stream-prefix": "ecs"
           }
         }
       }
     ],
     "requiresCompatibilities": [
       "MANAGED_INSTANCES"
     ],
     "cpu": "1024",
     "memory": "2048"
   }
   ```

1. Pilih **Buat**.

## Langkah 3: Buat layanan
<a name="getting-started-step3"></a>

Layanan Amazon ECS memungkinkan Anda menjalankan dan memelihara sejumlah instans definisi tugas yang ditentukan secara bersamaan di kluster Amazon ECS. Ikuti langkah-langkah ini untuk membuat layanan:

1. Di panel navigasi, pilih **Clusters**, lalu pilih cluster. **managed-instance-tutorial**

1. Dari tab **Layanan**, pilih **Buat**.

1. Untuk **keluarga definisi Tugas**, pilih **managed-instance-tutorial**.

1. Untuk **nama Layanan**, masukkan**managed-instance-tutorial-service**.

1. Di bawah **Lingkungan**, Pilih **strategi penyedia Kapasitas**.

1. Di bawah **Jaringan**, konfigurasikan hal berikut:

   1. Pilih VPC yang sudah ada atau buat yang baru.

   1. Untuk **Subnet**, pilih subnet yang akan digunakan.

   1. Untuk **grup Keamanan**, pilih grup keamanan yang ada atau buat grup baru yang memungkinkan lalu lintas masuk di port 80.

1. Pilih **Buat**.

## Langkah 4: Melihat layanan Anda
<a name="getting-started-step4"></a>

Setelah layanan Anda diluncurkan, Anda dapat melihatnya untuk mempelajari lebih lanjut dan mengujinya.

1. Pilih **managed-instance-tutorial-service** layanan.

1. Dari tab **Tugas**, pilih ID tugas tugas tugas yang sedang berjalan.

1. Di bawah **Jaringan**, di **IP Publik**, pilih **Buka alamat**.

1. Anda akan melihat halaman uji Apache HTTP Server, yang mengonfirmasi bahwa server web berjalan dengan benar.

## Langkah 5: Bersihkan
<a name="getting-started-step5"></a>

Setelah selesai dengan tutorial ini, Anda harus membersihkan sumber daya terkait untuk menghindari biaya untuk sumber daya yang tidak Anda gunakan.

1. Pada panel navigasi, silakan pilih **Klaster**.

1. Pada halaman **Clusters**, pilih **managed-instance-tutorial** cluster.

1. Pilih tab **Layanan**.

1. Pilih **managed-instance-tutorial-service** layanan, lalu pilih **Hapus**.

1. Pada prompt konfirmasi, masukkan **delete** lalu pilih **Hapus**.

1. Setelah layanan dihapus, pilih **Cluster** di panel navigasi.

1. Pada halaman **Clusters**, pilih **managed-instance-tutorial** cluster, lalu pilih **Delete cluster**.

1. Pada prompt konfirmasi, masukkan **delete managed-instance-tutorial** lalu pilih **Hapus**.