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

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 perbarui atau sertakan 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 dengan koneksi akun lingkungan saat ini dibuat.

  • > Koneksi akun lingkungan dikaitkan dengan lingkungan saat ini.

Jika lingkungan tidak terkait dengan koneksi akun lingkungan, jangan perbarui atau sertakan environmentAccountConnectionId parameternya.

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

Jika lingkungan Anda menggunakan penyediaan yang dikelola sendiri, jangan perbarui provisioning-repository parameter dan hilangkan parameter dan. 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 Edit, Perbarui, Perbarui minor, dan Perbarui tindakan utama yang diturunkan dari Tindakan.

NONE

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

CURRENT_VERSION

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

MINOR_VERSION

Dalam mode ini, lingkungan digunakan dan diperbarui dengan versi minor yang dipublikasikan 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 mayor dan minor yang diterbitkan, direkomendasikan (terbaru) dari template saat ini secara default. Anda juga dapat menentukan versi mayor yang berbeda yang lebih tinggi dari versi utama yang digunakan dan versi minor (opsional).

Memperbarui lingkungan penyediaan AWS terkelola

Penyediaan standar hanya didukung oleh lingkungan yang menyediakan. AWS CloudFormation

Gunakan konsol atau AWS CLI untuk memperbarui lingkungan Anda.

AWS Management Console
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 Berikutnya.

      3. Tinjau hasil edit Anda dan pilih Perbarui.

    2. Untuk membuat pembaruan pada input metadata saja.

      1. Pilih Tindakan dan kemudian Perbarui.

      2. Isi formulir dan pilih Edit.

      3. Isi formulir dan pilih Berikutnya hingga Anda mencapai halaman Ulasan.

      4. Tinjau pembaruan Anda dan pilih Perbarui.

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

      1. Pilih Tindakan dan kemudian Perbarui minor.

      2. Isi formulir dan pilih Berikutnya.

      3. Isi formulir dan pilih Berikutnya hingga Anda mencapai halaman Ulasan.

      4. Tinjau pembaruan Anda dan pilih Perbarui.

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

      1. Pilih Tindakan dan kemudian Perbarui mayor.

      2. Isi formulir dan pilih Berikutnya.

      3. Isi formulir dan pilih Berikutnya hingga Anda mencapai halaman Ulasan.

      4. Tinjau pembaruan Anda dan pilih Perbarui.

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 mengkonfirmasi 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

Penyediaan yang dikelola sendiri hanya didukung oleh lingkungan yang menyediakan Terraform.

Gunakan konsol atau AWS CLI untuk memperbarui lingkungan Anda.

AWS Management Console
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 templat 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 Berikutnya.

      3. Tinjau hasil edit Anda dan pilih Perbarui.

    2. Untuk membuat pembaruan pada input metadata saja.

      1. Pilih Tindakan dan kemudian Perbarui.

      2. Isi formulir dan pilih Edit.

      3. Isi formulir dan pilih Berikutnya hingga Anda mencapai halaman Ulasan.

      4. Tinjau pembaruan Anda dan pilih Perbarui.

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

      1. Pilih Tindakan dan kemudian Perbarui minor.

      2. Isi formulir dan pilih Berikutnya.

      3. Isi formulir dan pilih Berikutnya hingga Anda mencapai halaman Ulasan.

      4. Tinjau pembaruan Anda dan pilih Perbarui.

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

      1. Pilih Tindakan dan kemudian Perbarui mayor.

      2. Isi formulir dan pilih Berikutnya.

      3. Isi formulir dan pilih Berikutnya hingga Anda mencapai halaman Ulasan.

      4. Tinjau pembaruan Anda dan pilih Perbarui.

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 mengkonfirmasi 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 waktu 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 ada diIN_PROGRESS. AWS Proton upaya untuk membatalkan penyebaran. Pembatalan yang berhasil tidak dijamin.

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

Dengan AWS-managed provisioning, AWS Proton lakukan hal berikut:

  • Menetapkan status penerapan keCANCELLING.

  • Menghentikan penerapan yang sedang berlangsung dan menghapus sumber daya baru apa pun yang dibuat oleh penerapan saat. IN_PROGRESS

  • Menetapkan status penerapan keCANCELLED.

  • Mengembalikan status sumber daya ke keadaan sebelum penerapan dimulai.

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

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

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

Untuk petunjuk tentang cara membatalkan penerapan lingkungan, lihat CancelEnvironmentDeploymentdi AWS Proton APIReferensi.

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

AWS Management Console

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 penyebaran yang ingin Anda batalkan.

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

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

  5. Status penyebaran pembaruan Anda diatur ke Membatalkan dan kemudian Dibatalkan untuk menyelesaikan pembatalan.

AWS CLI

Gunakan AWS Proton AWS CLI untuk membatalkan penerapan pembaruan PROGRESS lingkungan IN_ 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"
    }
}