

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.

# Mengedit layanan
<a name="ag-svc-update"></a>

Anda dapat melakukan pengeditan berikut ke AWS Proton layanan.
+ Edit deskripsi layanan.
+ Edit layanan dengan menambahkan dan menghapus instance layanan.

## Edit deskripsi layanan
<a name="ag-svc-metadata"></a>

Anda dapat menggunakan konsol atau AWS CLI untuk mengedit deskripsi layanan.

------
#### [ Konsol Manajemen AWS ]

**Edit layanan menggunakan konsol seperti yang dijelaskan dalam langkah-langkah berikut.**

**Dalam daftar layanan.**

1. Di [AWS Proton konsol](https://console.aws.amazon.com//proton/), pilih **Layanan**.

1. Dalam daftar layanan, pilih tombol radio di sebelah kiri layanan yang ingin Anda perbarui.

1. Pilih **Edit**.

1. Di halaman **Konfigurasi layanan**, isi formulir dan pilih **Berikutnya**.

1. Di halaman **Konfigurasi pengaturan kustom**, pilih **Berikutnya**.

1. Tinjau hasil edit Anda dan pilih **Simpan perubahan**.

**Di halaman detail layanan.**

1. Di [AWS Proton konsol](https://console.aws.amazon.com//proton/), pilih **Layanan**.

1. Dalam daftar layanan, pilih nama layanan yang ingin Anda edit.

1. Di halaman detail layanan, pilih **Edit**.

1. Di halaman **Konfigurasi layanan**, isi formulir dan pilih **Berikutnya**.

1. Di halaman **Konfigurasi pengaturan khusus**, isi formulir dan pilih **Berikutnya**.

1. Tinjau hasil edit Anda dan pilih **Simpan perubahan**.

------
#### [ AWS CLI ]

**Mengedit deskripsi seperti yang ditunjukkan dalam contoh CLI berikut perintah dan respon.**

Perintah:

```
$ aws proton update-service \
    --name "{{MySimpleService}}" \
    --description "{{Edit by updating description}}"
```

Respons:

```
{
    "service": {
        "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService",
        "branchName": "main",
        "createdAt": "2021-03-12T22:39:42.318000+00:00",
        "description": "Edit by updating description",
        "lastModifiedAt": "2021-03-12T22:44:21.975000+00:00",
        "name": "MySimpleService",
        "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryId": "my-repository/myorg-myapp",
        "status": "ACTIVE",
        "templateName": "fargate-service"
    }
}
```

------

## Mengedit layanan untuk menambah atau menghapus instance layanan
<a name="ag-svc-update-instances"></a>

Untuk AWS Proton layanan, Anda dapat menambahkan atau menghapus instance layanan dengan mengirimkan spesifikasi yang telah diedit. Ketentuan berikut harus dipenuhi untuk permintaan yang berhasil:
+ Layanan dan pipeline Anda belum diedit atau dihapus saat Anda mengirimkan permintaan edit.
+ Spesifikasi Anda yang telah diedit tidak menyertakan pengeditan yang mengubah pipeline layanan atau pengeditan ke instance layanan yang ada yang *tidak* akan dihapus.
+ Spesifikasi Anda yang telah diedit tidak menghapus instance layanan yang ada yang memiliki komponen terlampir. Untuk menghapus instance layanan seperti itu, Anda harus memperbarui komponen terlebih dahulu untuk melepaskannya dari instance layanannya. Untuk informasi selengkapnya tentang komponen, lihat[AWS Proton komponen](ag-components.md).

Instans yang gagal penghapusan adalah instance layanan di negara bagian. `DELETE_FAILED` Saat Anda meminta pengeditan layanan, AWS Proton upaya menghapus instans yang gagal dihapus untuk Anda, sebagai bagian dari proses pengeditan. Jika salah satu instance layanan Anda gagal dihapus, mungkin masih ada sumber daya yang terkait dengan instans, meskipun tidak terlihat dari konsol atau. AWS CLI Periksa sumber daya infrastruktur instans yang gagal dihapus dan bersihkan sehingga AWS Proton dapat menghapusnya untuk Anda.

Untuk kuota instans layanan untuk layanan, lihat. [AWS Proton kuota](ag-limits.md) Anda juga harus menyimpan setidaknya 1 instance layanan untuk layanan Anda setelah dibuat. Selama proses pembaruan, AWS Proton hitung instance layanan yang ada dan instance yang akan ditambahkan atau dihapus. Instans yang gagal penghapusan disertakan dalam hitungan ini dan Anda harus memperhitungkannya saat mengedit. `spec`

### Gunakan konsol atau AWS CLI untuk menambah atau menghapus instance layanan
<a name="ag-svc-update-console-cli"></a>

------
#### [ Konsol Manajemen AWS ]

**Edit layanan Anda untuk menambah atau menghapus instance layanan menggunakan konsol.**

Di [AWS Proton konsol](https://console.aws.amazon.com//proton/)

1. Pada panel navigasi, silakan pilih **Layanan**.

1. Pilih layanan yang ingin Anda edit.

1. Pilih **Edit**.

1. (Opsional) Pada halaman **Konfigurasi layanan**, edit nama atau deskripsi layanan, lalu pilih **Berikutnya**.

1. Pada halaman **Konfigurasi pengaturan kustom**, pilih **Hapus** untuk menghapus instance layanan dan pilih **Tambahkan instance baru** untuk menambahkan instance layanan dan mengisi formulir.

1. Pilih **Berikutnya**.

1. Tinjau pembaruan Anda dan pilih **Simpan perubahan**.

1. Modal meminta Anda untuk memverifikasi penghapusan instance layanan. Ikuti instruksi dan pilih **Ya, hapus**.

1. Pada halaman detail layanan, lihat detail status untuk layanan Anda.

------
#### [ AWS CLI ]

**Tambahkan dan hapus instance layanan dengan diedit `spec` seperti yang ditunjukkan pada AWS CLI contoh perintah dan tanggapan berikut.**

Saat Anda menggunakan CLI, Anda `spec` harus *mengecualikan* instance layanan untuk dihapus dan *menyertakan* instance layanan yang akan ditambahkan dan instance layanan yang ada yang *belum* Anda tandai untuk dihapus.

Daftar berikut menunjukkan contoh `spec` sebelum pengeditan dan daftar instance layanan yang digunakan oleh spesifikasi. Spesifikasi ini digunakan dalam contoh sebelumnya untuk mengedit deskripsi layanan.

Spesifikasi:

```
proton: ServiceSpec

pipeline:
  my_sample_pipeline_optional_input: "abc"
  my_sample_pipeline_required_input: "123"

instances:
  - name: "my-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_optional_input: "def"
      my_sample_service_instance_required_input: "456"
  - name: "my-other-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "789"
```

Contoh berikut CLI `list-service-instances` perintah dan respon menunjukkan instance aktif sebelum menambahkan atau menghapus instance layanan.

Perintah:

```
$ aws proton list-service-instances \
    --service-name "{{MySimpleService}}"
```

Respons:

```
{
    "serviceInstances": [
        {
            "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService/service-instance/my-other-instance",
            "createdAt": "2021-03-12T22:39:42.318000+00:00",
            "deploymentStatus": "SUCCEEDED",
            "environmentName": "simple-env",
            "lastDeploymentAttemptedAt": "2021-03-12T22:39:43.109000+00:00",
            "lastDeploymentSucceededAt": "2021-03-12T22:39:43.109000+00:00",
            "name": "my-other-instance",
            "serviceName": "example-svc",
            "templateMajorVersion": "1",
            "templateMinorVersion": "0",
            "templateName": "fargate-service"
        },
        {
            "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService/service-instance/my-instance",
            "createdAt": "2021-03-12T22:39:42.318000+00:00",
            "deploymentStatus": "SUCCEEDED",
            "environmentName": "simple-env",
            "lastDeploymentAttemptedAt": "2021-03-12T22:39:43.160000+00:00",
            "lastDeploymentSucceededAt": "2021-03-12T22:39:43.160000+00:00",
            "name": "my-instance",
            "serviceName": "example-svc",
            "serviceTemplateArn": "arn:aws:proton:region-id:123456789012:service-template/fargate-service",
            "templateMajorVersion": "1",
            "templateMinorVersion": "0",
            "templateName": "fargate-service"
        }
    ]
}
```

Daftar berikut menunjukkan contoh diedit yang `spec` digunakan untuk menghapus dan menambahkan instance. Instance yang `my-instance` ada bernama dihapus dan instance baru bernama `yet-another-instance` ditambahkan.

Spesifikasi:

```
proton: ServiceSpec

pipeline:
  my_sample_pipeline_optional_input: "abc"
  my_sample_pipeline_required_input: "123"

instances:
  - name: "my-other-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "789"
  - name: "yet-another-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "789"
```

Anda dapat menggunakan `"${Proton::CURRENT_VAL}"` untuk menunjukkan nilai parameter mana yang harus dipertahankan dari aslinya`spec`, jika nilainya ada di`spec`. Gunakan `get-service` untuk melihat yang asli `spec` untuk layanan, seperti yang dijelaskan dalam[Lihat data layanan](ag-svc-view.md).

Daftar berikut menunjukkan cara yang dapat Anda gunakan `"${Proton::CURRENT_VAL}"` untuk memastikan bahwa Anda `spec` *tidak* menyertakan perubahan nilai parameter agar instance layanan yang ada tetap ada.

Spesifikasi:

```
proton: ServiceSpec

pipeline:
  my_sample_pipeline_optional_input: "${Proton::CURRENT_VAL}"
  my_sample_pipeline_required_input: "${Proton::CURRENT_VAL}"

instances:
  - name: "my-other-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "${Proton::CURRENT_VAL}"
  - name: "yet-another-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "789"
```

Daftar berikutnya menunjukkan perintah CLI dan respons untuk mengedit layanan.

Perintah:

```
$ aws proton update-service 
    --name "{{MySimpleService}}" \
    --description "{{Edit by adding and deleting a service instance}}" \
    --spec "{{file://spec.yaml}}"
```

Respons:

```
{
    "service": {
        "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService",
        "branchName": "main",
        "createdAt": "2021-03-12T22:39:42.318000+00:00",
        "description": "Edit by adding and deleting a service instance",
        "lastModifiedAt": "2021-03-12T22:55:48.169000+00:00",
        "name": "MySimpleService",
        "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryId": "my-repository/myorg-myapp",
        "status": "UPDATE_IN_PROGRESS",
        "templateName": "fargate-service"
    }
}
```

`list-service-instances`Perintah dan respons berikut mengonfirmasi bahwa instance yang `my-instance` ada bernama dihapus dan instance baru bernama `yet-another-instance` ditambahkan.

Perintah:

```
$ aws proton list-service-instances \
    --service-name "{{MySimpleService}}"
```

Respons:

```
{
    "serviceInstances": [
        {
            "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService/service-instance/yet-another-instance",
            "createdAt": "2021-03-12T22:39:42.318000+00:00",
            "deploymentStatus": "SUCCEEDED",
            "environmentName": "simple-env",
            "lastDeploymentAttemptedAt": "2021-03-12T22:56:01.565000+00:00",
            "lastDeploymentSucceededAt": "2021-03-12T22:56:01.565000+00:00",
            "name": "yet-another-instance",
            "serviceName": "MySimpleService",
            "templateMajorVersion": "1",
            "templateMinorVersion": "0",
            "templateName": "fargate-service"
        },
        {
            "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService/service-instance/my-other-instance",
            "createdAt": "2021-03-12T22:39:42.318000+00:00",
            "deploymentStatus": "SUCCEEDED",
            "environmentName": "simple-env",
            "lastDeploymentAttemptedAt": "2021-03-12T22:39:43.109000+00:00",
            "lastDeploymentSucceededAt": "2021-03-12T22:39:43.109000+00:00",
            "name": "my-other-instance",
            "serviceName": "MySimpleService",
            "templateMajorVersion": "1",
            "templateMinorVersion": "0",
            "templateName": "fargate-service"
        }
    ]
}
```

------

### Apa yang terjadi ketika Anda menambahkan atau menghapus instance layanan
<a name="ag-svc-add-delete"></a>

Setelah Anda mengirimkan suntingan layanan untuk menghapus dan menambahkan instance layanan, AWS Proton lakukan tindakan berikut.
+ Menetapkan layanan ke`UPDATE_IN_PROGRESS`.
+ Jika layanan memiliki pipeline, tetapkan statusnya ke `IN_PROGRESS` dan blokir tindakan pipeline.
+ Menetapkan instance layanan apa pun yang akan dihapus. `DELETE_IN_PROGRESS`
+ Memblokir tindakan layanan.
+ Memblokir tindakan pada instance layanan yang ditandai untuk dihapus.
+ Membuat instance layanan baru.
+ Menghapus instance yang Anda cantumkan untuk dihapus.
+ Mencoba untuk menghapus instance deletion-failed.
+ Setelah penambahan dan penghapusan selesai, berikan kembali jalur pipa layanan (jika ada), atur layanan Anda `ACTIVE` dan aktifkan tindakan layanan dan saluran pipa.

AWS Proton mencoba untuk menengahi kembali mode kegagalan sebagai berikut.
+ Jika satu atau beberapa instance layanan *gagal dibuat*, AWS Proton coba hapus penyediaan semua instance layanan yang baru dibuat dan kembalikan `spec` ke status sebelumnya. Itu *tidak* menghapus instance layanan apa pun dan *tidak* mengubah pipeline dengan cara apa pun.
+ Jika satu atau beberapa instance layanan *gagal dihapus, berikan* AWS Proton kembali pipeline tanpa instans yang dihapus. `spec`Ini diperbarui untuk menyertakan instance yang ditambahkan dan untuk mengecualikan instance yang ditandai untuk dihapus.
+ Jika *pipeline gagal dalam penyediaan*, rollback *tidak* dicoba dan layanan dan pipeline mencerminkan status pembaruan yang gagal.

### Penandaan dan pengeditan layanan
<a name="ag-svc-update-tagging"></a>

Saat Anda menambahkan instance layanan sebagai bagian dari pengeditan layanan, tag AWS terkelola menyebar ke dan secara otomatis dibuat untuk instance baru dan sumber daya yang disediakan. Jika Anda membuat tag baru, tag tersebut hanya diterapkan ke instance baru. Tag terkelola pelanggan layanan yang ada juga menyebar ke instance baru. Untuk informasi selengkapnya, lihat [AWS Proton sumber daya dan penandaan](resources.md).