View a markdown version of this page

Menunda konfigurasi volume untuk waktu peluncuran dalam definisi tugas Amazon ECS - Amazon Elastic Container Service

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

Menunda konfigurasi volume untuk waktu peluncuran dalam definisi tugas Amazon ECS

Untuk mengonfigurasi volume Amazon EBS untuk lampiran tugas Anda, Anda harus menentukan konfigurasi titik pemasangan dalam definisi tugas dan memberi nama volume. Anda juga harus mengatur configuredAtLaunch kepada true karena volume Amazon EBS tidak dapat dikonfigurasi untuk lampiran dalam definisi tugas. Sebaliknya, volume Amazon EBS dikonfigurasi untuk lampiran selama penerapan.

Untuk mendaftarkan definisi tugas dengan menggunakan AWS Command Line Interface (AWS CLI), simpan template sebagai file JSON, dan kemudian berikan file sebagai input untuk register-task-definition perintah.

Untuk membuat dan mendaftarkan definisi tugas menggunakan Konsol Manajemen AWS, lihat Membuat definisi tugas Amazon ECS menggunakan konsol.

Definisi tugas berikut menunjukkan sintaks untuk mountPoints dan volumes objek dalam definisi tugas. Untuk informasi selengkapnya tentang parameter definisi tugas, lihat Parameter definisi tugas Amazon ECS untuk Fargate. Untuk menggunakan contoh ini, ganti user input placeholdersdengan informasi Anda sendiri.

{
    "family": "mytaskdef",
    "containerDefinitions": [
        {
            "name": "nginx",
            "image": "public.ecr.aws/nginx/nginx:latest",
            "networkMode": "awsvpc",
           "portMappings": [
                {
                    "name": "nginx-80-tcp",
                    "containerPort": 80,
                    "hostPort": 80,
                    "protocol": "tcp",
                    "appProtocol": "http"
                }
            ],
            "mountPoints": [
                {
                    "sourceVolume": "myEBSVolume",
                    "containerPath": "/mount/ebs",
                    "readOnly": true
                }
            ]
        }
    ],
    "volumes": [
        {
            "name": "myEBSVolume",
            "configuredAtLaunch": true
        }
    ],
    "requiresCompatibilities": [
        "FARGATE", "EC2"
    ],
    "cpu": "1024",
    "memory": "3072",
    "networkMode": "awsvpc"
}
{
    "family": "mytaskdef",
     "memory": "4096",
     "cpu": "2048",
    "family": "windows-simple-iis-2019-core",
    "executionRoleArn": "arn:aws:iam::012345678910:role/ecsTaskExecutionRole",
    "runtimePlatform": {"operatingSystemFamily": "WINDOWS_SERVER_2019_CORE"},
    "requiresCompatibilities": ["EC2"]
    "containerDefinitions": [
        {
             "command": ["New-Item -Path C:\\inetpub\\wwwroot\\index.html -Type file -Value '<html> <head> <title>Amazon ECS Sample App</title> <style>body {margin-top: 40px; background-color: #333;} </style> </head><body> <div style=color:white;text-align:center> <h1>Amazon ECS Sample App</h1> <h2>Congratulations!</h2> <p>Your application is now running on a container in Amazon ECS.</p>'; C:\\ServiceMonitor.exe w3svc"],
            "entryPoint": [
                "powershell",
                "-Command"
            ],
            "essential": true,
            "cpu": 2048,
            "memory": 4096,
            "image": "mcr.microsoft.com/windows/servercore/iis:windowsservercore-ltsc2019",
            "name": "sample_windows_app",
            "portMappings": [
                {
                    "hostPort": 443,
                    "containerPort": 80,
                    "protocol": "tcp"
                }
            ],
            "mountPoints": [
                {
                    "sourceVolume": "myEBSVolume",
                    "containerPath": "drive:\ebs",
                    "readOnly": true
                }
            ]
        }
    ],
    "volumes": [
        {
            "name": "myEBSVolume",
            "configuredAtLaunch": true
        }
    ],
    "requiresCompatibilities": [
        "FARGATE", "EC2"
    ],
    "cpu": "1024",
    "memory": "3072",
    "networkMode": "awsvpc"
}
mountPoints

Tipe: Array objek

Wajib: Tidak

Titik pemasangan untuk volume data dalam wadah Anda. Parameter ini memetakan ke Volumes di Create-container Docker API dan --volume opsi untuk menjalankan docker.

Kontainer Windows dapat memasang seluruh direktori pada drive yang sama dengan $env:ProgramData. Wadah Windows tidak dapat memasang direktori pada drive yang berbeda, dan titik pemasangan tidak dapat digunakan di seluruh drive. Anda harus menentukan titik pemasangan untuk melampirkan volume Amazon EBS langsung ke tugas Amazon ECS.

sourceVolume

Tipe: String

Diperlukan: Ya, kapan mountPoints digunakan

Nama volume yang akan dipasang.

containerPath

Tipe: String

Diperlukan: Ya, kapan mountPoints digunakan

Jalur di wadah tempat volume akan dipasang.

readOnly

Tipe: Boolean

Wajib: Tidak

Jika nilai ini adalah true, kontainer memiliki akses hanya-baca ke volume. Jika nilai ini adalah false, maka kontainer dapat menulis ke volume. Nilai default-nya adalah false.

Untuk tugas yang berjalan pada instans EC2 yang menjalankan sistem operasi Windows, biarkan nilai sebagai default false.

name

Tipe: String

Wajib: Tidak

Nama volume. Hingga 255 huruf (huruf besar dan kecil), angka, tanda hubung (-), dan menggarisbawahi (_) diperbolehkan. Nama ini dirujuk dalam sourceVolume parameter definisi wadah mountPoints objek.

configuredAtLaunch

Jenis: Boolean

Wajib: Ya, jika Anda ingin menggunakan lampirkan volume EBS langsung ke tugas.

Menentukan apakah volume dapat dikonfigurasi saat peluncuran. Saat disetel ke true, Anda dapat mengonfigurasi volume saat menjalankan tugas mandiri, atau saat Anda membuat atau memperbarui layanan. Saat disetel ke false, Anda tidak akan dapat memberikan konfigurasi volume lain dalam definisi tugas. Parameter ini harus disediakan dan diatur ke true untuk mengonfigurasi volume Amazon EBS untuk lampiran pada tugas.