Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, AWS akan mengakhiri dukungan 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 Pengakhiran Layanan dan Migrasi](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html).
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 ini`deployment-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 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).
**Topics**
+ [Memperbarui lingkungan penyediaan AWS terkelola](#ag-env-std-update)
+ [Memperbarui lingkungan penyediaan yang dikelola sendiri](#ag-env-pr-update)
+ [Membatalkan penerapan lingkungan yang sedang berlangsung](#ag-env-cancel)
## Memperbarui lingkungan penyediaan AWS terkelola
Penyediaan standar hanya didukung oleh lingkungan yang menyediakan. 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](https://console.aws.amazon.com//proton/), pilih **Lingkungan**.
1. Dalam daftar lingkungan, pilih tombol radio di sebelah kiri lingkungan yang ingin Anda perbarui.
1.
****Di halaman detail lingkungan konsol.****
1. Di [AWS Proton konsol](https://console.aws.amazon.com//proton/), pilih **Lingkungan**.
1. Dalam daftar lingkungan, pilih nama lingkungan yang ingin Anda perbarui.
1.
**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**.
1. Isi formulir dan pilih **Berikutnya**.
1. Tinjau hasil edit Anda dan pilih **Perbarui**.
1.
**Untuk membuat pembaruan pada input metadata saja.**
1. Pilih **Tindakan** dan kemudian **Perbarui**.
1. Isi formulir dan pilih **Edit**.
1. Isi formulir dan pilih **Berikutnya** hingga Anda mencapai halaman **Ulasan**.
1. Tinjau pembaruan Anda dan pilih **Perbarui**.
1.
**Untuk membuat pembaruan ke versi minor baru dari template lingkungannya.**
1. Pilih **Tindakan** dan kemudian **Perbarui minor**.
1. Isi formulir dan pilih **Berikutnya**.
1. Isi formulir dan pilih **Berikutnya** hingga Anda mencapai halaman **Ulasan**.
1. Tinjau pembaruan Anda dan pilih **Perbarui**.
1.
**Untuk membuat pembaruan ke versi utama baru dari template lingkungannya.**
1. Pilih **Tindakan** dan kemudian **Perbarui mayor**.
1. Isi formulir dan pilih **Berikutnya**.
1. Isi formulir dan pilih **Berikutnya** hingga Anda mencapai halaman **Ulasan**.
1. 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.**
------
#### [ 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](https://console.aws.amazon.com//proton/), pilih **Lingkungan**.
1. Dalam daftar lingkungan, pilih tombol radio di sebelah kiri templat lingkungan yang ingin Anda perbarui.
1.
****Di halaman detail lingkungan konsol.****
1. Di [AWS Proton konsol](https://console.aws.amazon.com//proton/), pilih **Lingkungan**.
1. Dalam daftar lingkungan, pilih nama lingkungan yang ingin Anda perbarui.
1.
**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**.
1. Isi formulir dan pilih **Berikutnya**.
1. Tinjau hasil edit Anda dan pilih **Perbarui**.
1.
**Untuk membuat pembaruan pada input metadata saja.**
1. Pilih **Tindakan** dan kemudian **Perbarui**.
1. Isi formulir dan pilih **Edit**.
1. Isi formulir dan pilih **Berikutnya** hingga Anda mencapai halaman **Ulasan**.
1. Tinjau pembaruan Anda dan pilih **Perbarui**.
1.
**Untuk membuat pembaruan ke versi minor baru dari template lingkungannya.**
1. Pilih **Tindakan** dan kemudian **Perbarui minor**.
1. Isi formulir dan pilih **Berikutnya**.
1. Isi formulir dan pilih **Berikutnya** hingga Anda mencapai halaman **Ulasan**.
1. Tinjau pembaruan Anda dan pilih **Perbarui**.
1.
**Untuk membuat pembaruan ke versi utama baru dari template lingkungannya.**
1. Pilih **Tindakan** dan kemudian **Perbarui mayor**.
1. Isi formulir dan pilih **Berikutnya**.
1. Isi formulir dan pilih **Berikutnya** hingga Anda mencapai halaman **Ulasan**.
1. 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"
}
}
```
1. 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"
}
}
```
1. 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.
1. 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 di`IN_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 ke`CANCELLING`.
+ Menghentikan penerapan yang sedang berlangsung dan menghapus sumber daya baru apa pun yang dibuat oleh penerapan saat. `IN_PROGRESS`
+ Menetapkan status penerapan ke`CANCELLED`.
+ 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 [CancelEnvironmentDeployment](https://docs.aws.amazon.com/proton/latest/APIReference/API_CancelEnvironmentDeployment.html)di *Referensi AWS Proton 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](https://console.aws.amazon.com//proton/), pilih **Lingkungan** di panel navigasi.
1. Dalam daftar lingkungan, pilih nama lingkungan dengan pembaruan penyebaran yang ingin Anda batalkan.
1. Jika status penyebaran pembaruan Anda **sedang berlangsung, di** halaman detail lingkungan, pilih **Tindakan**, lalu **Batalkan penerapan**.
1. Modal meminta Anda untuk mengonfirmasi bahwa Anda ingin membatalkan. Pilih **Batalkan penerapan**.
1. Status penyebaran pembaruan Anda diatur ke **Membatalkan** dan kemudian **Dibatalkan untuk menyelesaikan pembatalan**.
------
#### [ AWS CLI ]
**Gunakan AWS Proton AWS CLI untuk 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 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"
}
}
```
------