View a markdown version of this page

Perbarui lingkungan - AWS Proton
Perbarui sebuah AWS lingkungan penyediaan terkelolaMemperbarui lingkungan penyediaan yang dikelola sendiriMembatalkan penerapan lingkungan yang sedang berlangsung

Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, dukungan AWS akan berakhir untuk AWS Proton. Setelah 7 Oktober 2026, Anda tidak akan lagi dapat mengakses AWS Proton konsol atau AWS Proton sumber daya. Infrastruktur yang Anda gunakan akan tetap utuh. Untuk informasi selengkapnya, lihat Panduan AWS Proton Penghentian Layanan dan Migrasi.

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

Perbarui lingkungan

Jika AWS Proton lingkungan dikaitkan dengan koneksi akun lingkungan, jangan memperbarui atau menyertakan protonServiceRoleArn parameter untuk memperbarui atau menyambung ke koneksi akun lingkungan.

Anda hanya dapat memperbarui ke koneksi akun lingkungan baru jika kedua hal berikut ini benar:

  • Koneksi akun lingkungan dibuat di akun lingkungan yang sama tempat koneksi akun lingkungan saat ini dibuat.

  • > Koneksi akun lingkungan dikaitkan dengan lingkungan saat ini.

Jika lingkungan tidak terkait dengan koneksi akun lingkungan, jangan per barui atau sertakan environmentAccountConnectionId parameter.

Anda dapat memperbarui protonServiceRoleArn parameter dan nilai environmentAccountConnectionId atau. Anda tidak dapat memperbarui keduanya.

Jika lingkungan Anda menggunakan penyediaan yang dikelola sendiri, jangan perbarui provisioning-repository parameter dan hilangkan parameter and. environmentAccountConnectionId protonServiceRoleArn

Ada empat mode untuk memperbarui lingkungan seperti yang dijelaskan dalam daftar berikut. Saat menggunakan AWS CLI, deployment-type bidang mendefinisikan mode. Saat menggunakan konsol, mode ini dipetakan ke tindakan utama Edit, Per barui, Per barui minor, dan Per barui yang turun dari Tind akan.

NONE

Dalam mode ini, pener apan tidak terjadi. Hanya parameter metadata yang diminta yang diperbarui.

CURRENT_VERSION

Dalam mode ini, lingkungan digunakan dan diperbarui dengan spesifikasi baru yang Anda berikan. Hanya parameter yang diminta yang diperbarui. Jangan ser takan parameter versi minor atau mayor saat Anda menggunakan inideployment-type.

MINOR_VERSION

Dalam mode ini, lingkungan digunakan dan diperbarui dengan versi minor yang diterbitkan dan direkomendasikan (terbaru) dari versi utama saat ini yang digunakan secara default. Anda juga dapat menentukan versi minor yang berbeda dari versi utama saat ini yang digunakan.

MAJOR_VERSION

Dalam mode ini, lingkungan digunakan dan diperbarui dengan versi utama dan minor yang diterbitkan, direkomendasikan (terbaru) dari template saat ini secara default. Anda juga dapat menentukan versi utama yang berbeda yang lebih tinggi dari versi utama yang digunakan dan versi minor (opsional).

Perbarui sebuah AWS lingkungan penyediaan terkelola

Penyediaan standar hanya didukung oleh lingkungan yang menyediakan dengan CloudFormation.

Gunakan konsol atau AWS CLI untuk memperbarui lingkungan Anda.

Konsol Manajemen AWS
Perbarui lingkungan menggunakan konsol seperti yang ditunjukkan pada langkah-langkah berikut.
  1. Pilih 1 dari 2 langkah berikut.
    1. Dalam daftar lingkungan.

      1. Di AWS Proton konsol, pilih Lingkungan.

      2. Dalam daftar lingkungan, pilih tombol radio di sebelah kiri lingkungan yang ingin Anda perbarui.

    2. Di halaman detail lingkungan konsol.

      1. Di AWS Proton konsol, pilih Lingkungan.

      2. Dalam daftar lingkungan, pilih nama lingkungan yang ingin Anda perbarui.

  2. Pilih 1 dari 4 langkah berikutnya untuk memperbarui lingkungan Anda.
    1. Untuk melakukan pengeditan yang tidak memerlukan penerapan lingkungan.

      1. Misalnya, untuk mengubah deskripsi.

        Pilih Edit.

      2. Isi formulir dan pilih Ber ikutnya.

      3. Tinjau suntingan Anda dan pilih Perbarui.

    2. Untuk membuat pembaruan pada input metadata saja.

      1. Pilih T ind akan dan kemudian Perbarui.

      2. Isi formulir dan pilih Edit.

      3. Isi formulir dan pilih Ber ikutnya hingga Anda mencapai halaman Review.

      4. Tinjau pembaruan Anda dan pilih Per barui.

    3. Untuk membuat pembaruan ke versi minor baru dari template lingkungannya.

      1. Pilih T ind akan dan kemudian Perbarui minor.

      2. Isi formulir dan pilih Ber ikutnya.

      3. Isi formulir dan pilih Ber ikutnya hingga Anda mencapai halaman Review.

      4. Tinjau pembaruan Anda dan pilih Per barui.

    4. Untuk membuat pembaruan ke versi utama baru dari template lingkungannya.

      1. Pilih T ind akan dan kemudian Perbarui mayor.

      2. Isi formulir dan pilih Ber ikutnya.

      3. Isi formulir dan pilih Ber ikutnya hingga Anda mencapai halaman Review.

      4. Tinjau pembaruan Anda dan pilih Per barui.

AWS CLI

Gunakan AWS Proton AWS CLI untuk memperbarui lingkungan ke versi minor baru.

Jalankan perintah berikut untuk memperbarui lingkungan Anda:

$ aws proton update-environment \
        --name "MySimpleEnv" \
        --deployment-type "MINOR_VERSION" \
        --template-major-version "1" \
        --template-minor-version "1" \
        --proton-service-role-arn arn:aws:iam::123456789012:role/service-role/ProtonServiceRole \
        --spec "file:///spec.yaml"

Respons:

{
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
        "createdAt": "2021-04-02T17:29:55.472000+00:00",
        "deploymentStatus": "IN_PROGRESS",        
        "lastDeploymentAttemptedAt": "2021-04-02T17:48:26.307000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T17:29:55.472000+00:00",
        "name": "MySimpleEnv",
        "protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
        "templateMajorVersion": "1",
        "templateMinorVersion": "0",
        "templateName": "simple-env"
    }
}

Jalankan perintah berikut untuk mendapatkan dan mengonfirmasi status:

$ aws proton get-environment \
        --name "MySimpleEnv"

Respons:

{
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
        "createdAt": "2021-04-02T17:29:55.472000+00:00",
        "deploymentStatus": "SUCCEEDED",
        "environmentName": "MySimpleEnv",
        "lastDeploymentAttemptedAt": "2021-04-02T17:48:26.307000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T17:48:26.307000+00:00",
        "protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
        "spec": "proton: EnvironmentSpec\n\nspec:\n  my_sample_input: hello\n  my_other_sample_input: everybody\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "simple-env"
    }
}

Memperbarui lingkungan penyediaan yang dikelola sendiri

Self-managed penyediaan hanya didukung oleh lingkungan yang menyediakan dengan Terraform.

Gunakan konsol atau AWS CLI untuk memperbarui lingkungan Anda.

Konsol Manajemen AWS
Perbarui lingkungan menggunakan konsol seperti yang ditunjukkan pada langkah-langkah berikut.
  1. Pilih 1 dari 2 langkah berikut.
    1. Dalam daftar lingkungan.

      1. Di AWS Proton konsol, pilih Lingkungan.

      2. Dalam daftar lingkungan, pilih tombol radio di sebelah kiri template lingkungan yang ingin Anda perbarui.

    2. Di halaman detail lingkungan konsol.

      1. Di AWS Proton konsol, pilih Lingkungan.

      2. Dalam daftar lingkungan, pilih nama lingkungan yang ingin Anda perbarui.

  2. Pilih 1 dari 4 langkah berikutnya untuk memperbarui lingkungan Anda.
    1. Untuk melakukan pengeditan yang tidak memerlukan penerapan lingkungan.

      1. Misalnya, untuk mengubah deskripsi.

        Pilih Edit.

      2. Isi formulir dan pilih Ber ikutnya.

      3. Tinjau suntingan Anda dan pilih Perbarui.

    2. Untuk membuat pembaruan pada input metadata saja.

      1. Pilih T ind akan dan kemudian Perbarui.

      2. Isi formulir dan pilih Edit.

      3. Isi formulir dan pilih Ber ikutnya hingga Anda mencapai halaman Review.

      4. Tinjau pembaruan Anda dan pilih Per barui.

    3. Untuk membuat pembaruan ke versi minor baru dari template lingkungannya.

      1. Pilih T ind akan dan kemudian Perbarui minor.

      2. Isi formulir dan pilih Ber ikutnya.

      3. Isi formulir dan pilih Ber ikutnya hingga Anda mencapai halaman Review.

      4. Tinjau pembaruan Anda dan pilih Per barui.

    4. Untuk membuat pembaruan ke versi utama baru dari template lingkungannya.

      1. Pilih T ind akan dan kemudian Perbarui mayor.

      2. Isi formulir dan pilih Ber ikutnya.

      3. Isi formulir dan pilih Ber ikutnya hingga Anda mencapai halaman Review.

      4. Tinjau pembaruan Anda dan pilih Per barui.

AWS CLI
Gunakan AWS CLI untuk memperbarui lingkungan Terraform ke versi minor baru dengan penyediaan yang dikelola sendiri.

  1. Jalankan perintah berikut untuk memperbarui lingkungan Anda:

    $ aws proton update-environment \
    --name "pr-environment" \
    --deployment-type "MINOR_VERSION" \
    --template-major-version "1" \
    --template-minor-version "1" \
    --provisioning-repository "branch=main,name=myrepos/env-repo,provider=GITHUB" \
    --spec "file://env-spec-mod.yaml"

    Respons:

    {
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/pr-environment",
        "createdAt": "2021-11-18T21:09:15.745000+00:00",
        "deploymentStatus": "IN_PROGRESS",
        "lastDeploymentAttemptedAt": "2021-11-18T21:25:41.998000+00:00",
        "lastDeploymentSucceededAt": "2021-11-18T21:09:15.745000+00:00",
        "name": "pr-environment",
        "provisioningRepository": {
            "arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/env-repo",
            "branch": "main",
            "name": "myrepos/env-repo",
            "provider": "GITHUB"
        },
        "templateMajorVersion": "1",
        "templateMinorVersion": "0",
        "templateName": "pr-env-template"
    }
}

  2. Jalankan perintah berikut untuk mendapatkan dan mengonfirmasi status:

    $ aws proton get-environment \
    --name "pr-environment"

    Respons:

    {
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/pr-environment",
        "createdAt": "2021-11-18T21:09:15.745000+00:00",
        "deploymentStatus": "SUCCEEDED",
        "lastDeploymentAttemptedAt": "2021-11-18T21:25:41.998000+00:00",
        "lastDeploymentSucceededAt": "2021-11-18T21:25:41.998000+00:00",
        "name": "pr-environment",
        "provisioningRepository": {
            "arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/env-repo",
            "branch": "main",
            "name": "myrepos/env-repo",
            "provider": "GITHUB"
        },
        "spec": "proton: EnvironmentSpec\nspec:\n   ssm_parameter_value: \"test\"\n ssm_another_parameter_value: \"update\"\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "pr-env-template"
    }
}

  3. Tinjau permintaan tarik yang dikirim oleh AWS Proton.

    • Jika Anda menyetujui permintaan, penyediaan sedang berlangsung.

    • Jika Anda menolak permintaan, pembuatan lingkungan dibatalkan.

    • Jika permintaan tarik habis, pembuatan lingkungan tidak selesai.

  4. Berikan status penyediaan ke AWS Proton.

    $ aws proton notify-resource-deployment-status-change \
    --resource-arn "arn:aws:proton:region-id:123456789012:environment/pr-environment" \
    --status "SUCCEEDED"

Membatalkan penerapan lingkungan yang sedang berlangsung

Anda dapat mencoba membatalkan penerapan pembaruan lingkungan jika deploymentStatus sudah masukIN_PROGRESS. AWS Proton mencoba untuk membatalkan penerapan. Pembatalan yang berhasil tidak dijamin.

Saat Anda membatalkan penerapan pembaruan, cobalah AWS Proton untuk membatalkan penerapan seperti yang tercantum dalam langkah-langkah berikut.

Dengan AWS-penyediaan yang dikelola, AWS Proton melakukan hal berikut:

  • Menyetel status penerapan keCANCELLING.

  • Menghentikan penerapan yang sedang berlangsung dan menghapus sumber daya baru yang dibuat oleh penerapan saatIN_PROGRESS.

  • Menyetel status penerapan keCANCELLED.

  • Mengembalikan status sumber daya ke keadaan sebelum penerapan dimulai.

Dengan penyediaan yang dikelola sendiri, AWS Proton melakukan hal berikut:

  • Mencoba menutup permintaan tarik untuk mencegah penggabungan perubahan ke repositori Anda.

  • Menetapkan status penerapan ke CANCELLED jika permintaan tarik berhasil ditutup.

Untuk petunjuk tentang cara membatalkan penerapan lingkungan, lihat CancelEnvironmentDeployment di Refer AWS Proton ensi API.

Anda dapat menggunakan konsol atau CLI untuk membatalkan lingkungan yang sedang berlangsung.

Konsol Manajemen AWS

Gunakan konsol untuk membatalkan penerapan pembaruan lingkungan seperti yang ditunjukkan pada langkah-langkah berikut.

  1. Di AWS Proton konsol, pilih Lingkungan di panel navigasi.

  2. Dalam daftar lingkungan, pilih nama lingkungan dengan pembaruan penerapan yang ingin Anda batalkan.

  3. Jika status penerapan pembaruan Anda sedang berlangsung, di halaman detail lingkungan, pilih Tindakan, lalu Bat alkan penerapan.

  4. Modal meminta Anda untuk mengonfirmasi bahwa Anda ingin membatalkan. Pilih Bat alkan penerapan.

  5. Status penerapan pembaruan Anda disetel ke Membatalkan dan kemudian Di batalkan untuk menyelesaikan pembatalan.

AWS CLI

Gunakan AWS Proton AWS CLI untuk membatalkan penerapan pembaruan lingkungan IN_PROGRESS ke versi minor baru 2.

Kondisi tunggu disertakan dalam template yang digunakan untuk contoh ini sehingga pembatalan dimulai sebelum penerapan pembaruan berhasil.

Jalankan perintah berikut untuk membatalkan pembaruan:

$ aws proton cancel-environment-deployment \
        --environment-name "MySimpleEnv"

Respons:

{
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
        "createdAt": "2021-04-02T17:29:55.472000+00:00",
        "deploymentStatus": "CANCELLING",
        "lastDeploymentAttemptedAt": "2021-04-02T18:15:10.243000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T17:48:26.307000+00:00",
        "name": "MySimpleEnv",
        "protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
        "spec": "proton: EnvironmentSpec\n\nspec:\n  my_sample_input: hello\n  my_other_sample_input: everybody\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "simple-env"
    }
}

Jalankan perintah berikut untuk mendapatkan dan mengonfirmasi status:”

$ aws proton get-environment \
        --name "MySimpleEnv"

Respons:

{
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
        "createdAt": "2021-04-02T17:29:55.472000+00:00",
        "deploymentStatus": "CANCELLED",
        "deploymentStatusMessage": "User initiated cancellation.",
        "lastDeploymentAttemptedAt": "2021-04-02T18:15:10.243000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T17:48:26.307000+00:00",
        "name": "MySimpleEnv",
        "protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
        "spec": "proton: EnvironmentSpec\n\nspec:\n  my_sample_input: hello\n  my_other_sample_input: everybody\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "simple-env"
    }
}