Memperbarui lingkungan - AWS Proton
MemperbaruiAWSlingkungan penyediaan terkelolaMemperbarui lingkungan penyediaan yang dikelola sendiriMembatalkan penyebaran lingkungan yang sedang berlangsung

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

Memperbarui lingkungan

JikaAWS Protonlingkungan dikaitkan dengan koneksi akun lingkungan,janganmemperbarui atau menyertakanprotonServiceRoleArnparameter untuk memperbarui atau terhubung 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 lingkungantidakterkait dengan koneksi akun lingkungan,janganmemperbarui atau menyertakanenvironmentAccountConnectionIdparameter.

Anda dapat memperbarui salah satuenvironmentAccountConnectionIdatauprotonServiceRoleArnparameter dan nilai. Anda tidak dapat memperbarui keduanya.

Jika lingkungan Anda menggunakan penyediaan yang dikelola sendiri,janganperbaruiprovisioning-repositoryparameter danmenghilangkansangenvironmentAccountConnectionIddanprotonServiceRoleArnparameter.

Ada empat mode untuk memperbarui lingkungan seperti yang dijelaskan dalam daftar berikut. Saat menggunakanAWS CLI, yangdeployment-typebidang mendefinisikan modus. Saat menggunakan konsol, mode ini memetakan keMengedit,Memperbarui,Perbarui minor, danPerbarui utamatindakan yang drop down dariAksi.

NONE

Dalam mode ini, penyebarantidakterjadi. Hanya parameter metadata yang diminta yang diperbarui.

CURRENT_VERSION

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

MINOR_VERSION

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

MAJOR_VERSION

Dalam mode ini, lingkungan dikerahkan dan diperbarui dengan versi utama dan minor yang dipublikasikan, 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).

MemperbaruiAWSlingkungan penyediaan terkelola

Penyediaan standar hanya didukung oleh lingkungan yang menyediakanAWS CloudFormation.

Gunakan konsol atauAWS CLIuntuk 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. DalamAWS Protonkonsol, pilihLingkungan.

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

    2. Di halaman detail lingkungan konsol.

      1. DalamAWS Protonkonsol, pilihLingkungan.

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

  2. Pilih 1 dari 4 langkah berikutnya untuk memperbarui lingkungan Anda.
    1. Untuk membuat edit yang tidak memerlukan penyebaran lingkungan.

      1. Misalnya, untuk mengubah deskripsi.

        Pilih Edit.

      2. Isi formulir dan pilihBerikutnya.

      3. Tinjau suntingan Anda dan pilihMemperbarui.

    2. Untuk membuat update ke input metadata saja.

      1. PilihAksidan kemudianMemperbarui.

      2. Isi formulir dan pilihMengedit.

      3. Isi formulir dan pilihBerikutnyasampai kamu mencapaiUlasanhalaman.

      4. Tinjau pembaruan Anda dan pilihMemperbarui.

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

      1. PilihAksidan kemudianPerbarui minor.

      2. Isi formulir dan pilihBerikutnya.

      3. Isi formulir dan pilihBerikutnyasampai kamu mencapaiUlasanhalaman.

      4. Tinjau pembaruan Anda dan pilihMemperbarui.

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

      1. PilihAksidan kemudianPerbarui utama.

      2. Isi formulir dan pilihBerikutnya.

      3. Isi formulir dan pilihBerikutnyasampai kamu mencapaiUlasanhalaman.

      4. Tinjau pembaruan Anda dan pilihMemperbarui.

AWS CLI

GunakanAWS Proton AWS CLIuntuk 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"

Jawaban:

{
    "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"

Jawaban:

{
    "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 dengan Terraform.

Gunakan konsol atauAWS CLIuntuk 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. DalamAWS Protonkonsol, pilihLingkungan.

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

    2. Di halaman detail lingkungan konsol.

      1. DalamAWS Protonkonsol, pilihLingkungan.

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

  2. Pilih 1 dari 4 langkah berikutnya untuk memperbarui lingkungan Anda.
    1. Untuk membuat edit yang tidak memerlukan penyebaran lingkungan.

      1. Misalnya, untuk mengubah deskripsi.

        Pilih Edit.

      2. Isi formulir dan pilihBerikutnya.

      3. Tinjau suntingan Anda dan pilihMemperbarui.

    2. Untuk membuat update ke input metadata saja.

      1. PilihAksidan kemudianMemperbarui.

      2. Isi formulir dan pilihMengedit.

      3. Isi formulir dan pilihBerikutnyasampai kamu mencapaiUlasanhalaman.

      4. Tinjau pembaruan Anda dan pilihMemperbarui.

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

      1. PilihAksidan kemudianPerbarui minor.

      2. Isi formulir dan pilihBerikutnya.

      3. Isi formulir dan pilihBerikutnyasampai kamu mencapaiUlasanhalaman.

      4. Tinjau pembaruan Anda dan pilihMemperbarui.

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

      1. PilihAksidan kemudianPerbarui utama.

      2. Isi formulir dan pilihBerikutnya.

      3. Isi formulir dan pilihBerikutnyasampai kamu mencapaiUlasanhalaman.

      4. Tinjau pembaruan Anda dan pilihMemperbarui.

AWS CLI
GunakanAWS CLIuntuk 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"

    Jawaban:

    {
    "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"

    Jawaban:

    {
    "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 pull request yang dikirim olehAWS Proton.

    • Jika Anda menyetujui permintaan, penyediaan sedang berlangsung.

    • Jika Anda menolak permintaan, pembuatan lingkungan dibatalkan.

    • Jika pull request habis, pembuatan lingkungan tidak lengkap.

  4. Memberikan status penyediaanAWS Proton.

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

Membatalkan penyebaran lingkungan yang sedang berlangsung

Anda dapat mencoba membatalkan penyebaran pembaruan lingkungan jikadeploymentStatusada diIN_PROGRESS.AWS Protonmencoba untuk membatalkan penyebaran. Pembatalan yang berhasiltidakdijamin.

Saat Anda membatalkan penyebaran pembaruan,AWS Protonmencoba untuk membatalkan penyebaran seperti yang tercantum dalam langkah-langkah berikut.

DenganAWS-managed provisioning,AWS Protonmelakukan hal berikut:

  • Menetapkan status penyebaran keCANCELLING.

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

  • Menetapkan status penyebaran keCANCELLED.

  • Mengembalikan status sumber daya ke apa itu sebelum penyebaran dimulai.

Dengan penyediaan yang dikelola sendiri,AWS Protonmelakukan hal berikut:

  • Upaya untuk menutup pull request untuk mencegah penggabungan perubahan ke repositori Anda.

  • Menetapkan status penyebaran keCANCELLEDjika pull request berhasil ditutup.

Untuk petunjuk tentang cara membatalkan penyebaran lingkungan, lihatCancelEnvironmentDeploymentdi dalamAWS ProtonReferensi API.

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

AWS Management Console

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

  1. DalamAWS Protonkonsol, pilihLingkungandi panel navigasi.

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

  3. Jika status penyebaran pembaruan AndaDalam kemajuan, di halaman detail lingkungan, pilihAksidan kemudianBatalkan penyebaran.

  4. Modal meminta Anda untuk mengonfirmasi bahwa Anda ingin membatalkan. PilihBatalkan penyebaran.

  5. Status penyebaran pembaruan Anda diatur keMembatalkandan kemudianDibatalkanuntuk menyelesaikan pembatalan.

AWS CLI

GunakanAWS Proton AWS CLIuntuk membatalkan penyebaran pembaruan lingkungan IN_PROGRESS ke versi minor baru 2.

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

Jalankan perintah berikut untuk membatalkan pembaruan:

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

Jawaban:

{
    "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 mengkonfirmasi status:”

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

Jawaban:

{
    "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"
    }
}