Edit deskripsi layanan Menambahkan atau menghapus instans layanan

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.

Mengedit layanan

Anda dapat melakukan pengeditan berikut pada AWS Proton layanan.

Edit deskripsi layanan.
Mengedit layanan dengan menambahkan dan menghapus instance layanan.

Edit deskripsi layanan

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

Konsol Manajemen AWS

Mengedit layanan menggunakan konsol seperti yang dijelaskan dalam langkah-langkah berikut.

Dalam daftar layanan.

Di AWS Proton konsol, pilih Layanan.
Dalam daftar layanan, pilih tombol radio di sebelah kiri layanan yang ingin Anda perbarui.
Pilih Edit.
Di halaman Konfigurasi layanan, isi formulir dan pilih Ber ikutnya.
Di halaman Konfigurasi pengaturan kustom, pilih Ber ikutnya.
Tinjau suntingan Anda dan pilih S impan perubahan.

Di halaman detail layanan.

Di AWS Proton konsol, pilih Layanan.
Dalam daftar layanan, pilih nama layanan yang ingin Anda edit.
Di halaman detail layanan, pilih Edit.
Di halaman Konfigurasi layanan, isi formulir dan pilih Ber ikutnya.
Di halaman Konfigurasi pengaturan kustom, isi formulir dan pilih Ber ikutnya.
Tinjau suntingan Anda dan pilih S impan perubahan.

AWS CLI

Edit deskripsi seperti yang ditunjukkan dalam contoh perintah dan respons CLI berikut.

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 instans layanan

Untuk AWS Proton layanan, Anda dapat menambah atau menghapus instans layanan dengan mengirimkan spesifikasi yang diedit. Ketentuan berikut harus dipenuhi untuk permintaan yang berhasil:

Layanan dan pipeline Anda belum diedit atau dihapus saat Anda mengirimkan permintaan edit.
Spesifikasi yang Anda edit tidak menyertakan pengeditan yang mengubah pipeline layanan atau pengeditan pada instans layanan yang ada yang tidak akan dihapus.
Spesifikasi yang Anda edit tidak menghapus instans layanan yang ada yang memiliki komponen terlampir. Untuk menghapus instance layanan seperti itu, Anda harus terlebih dahulu memperbarui komponen untuk melepaskannya dari instance layanannya. Untuk informasi selengkapnya tentang komponen, lihatAWS Proton komponen.

Deletion-failed instance adalah instance layanan di DELETE_FAILED negara bagian. Saat Anda meminta pengeditan layanan, mencoba AWS Proton menghapus instans penghapusan-gagal untuk Anda, sebagai bagian dari proses pengeditan. Jika salah satu instans 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 instance layanan untuk layanan, lihatAWS Proton kuota. Anda juga harus mempertahankan setidaknya 1 instance layanan untuk layanan Anda setelah dibuat. Selama proses pembaruan, AWS Proton menghitung instance layanan yang ada dan instans yang akan ditambahkan atau dihapus. Deletion-failed instance disertakan dalam hitungan ini dan Anda harus memperhitungkannya saat mengeditspec.

Gunakan konsol atau AWS CLI untuk menambah atau menghapus instans layanan

Konsol Manajemen AWS

Edit layanan Anda untuk menambah atau menghapus instans layanan menggunakan konsol.

Di AWS Proton konsol

Pada panel navigasi, silakan pilih Layanan.
Pilih layanan yang ingin Anda edit.
Pilih Edit.
(Opsional) Pada halaman Konfigurasi layanan, edit nama layanan atau deskripsi, lalu pilih Ber ikutnya.
Pada halaman Konfigurasi pengaturan kustom, pilih H apus untuk menghapus instance layanan dan pilih Tambahkan instance baru untuk menambahkan instance layanan dan mengisi formulir.
Pilih Berikutnya.
Tinjau pembaruan Anda dan pilih Simpan perubahan.
Modal meminta Anda untuk memverifikasi penghapusan instance layanan. Ikuti instruksi dan pilih Ya, hapus.
Pada halaman detail layanan, lihat detail status untuk layanan Anda.

AWS CLI

Tambahkan dan hapus instance layanan dengan yang diedit spec seperti yang ditunjukkan dalam AWS CLI contoh perintah dan respons berikut.

Saat Anda menggunakan CLI, Anda spec harus mengecualikan instans layanan untuk dihapus dan menyer takan instans layanan untuk ditambahkan dan instans layanan yang ada yang belum Anda tandai untuk dihapus.

Daftar berikut menunjukkan contoh spec sebelum edit 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 list-service-instances perintah dan respons CLI berikut 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 yang diedit 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 akan dipertahankan dari aslinyaspec, jika nilainya ada dispec. Gunakan get-service untuk melihat versi asli spec untuk layanan, seperti yang dijelaskan dalamLihat data layanan.

Daftar berikut menunjukkan cara Anda dapat menggunakan "${Proton::CURRENT_VAL}" untuk memastikan bahwa Anda spec tidak menyer takan perubahan nilai parameter agar instans 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"
    }
}

Per list-service-instances intah 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 saat Anda menambahkan atau menghapus instans layanan

Setelah Anda mengirimkan suntingan layanan untuk menghapus dan menambahkan instance layanan AWS Proton , lakukan tindakan berikut.

Menyetel layanan keUPDATE_IN_PROGRESS.
Jika layanan memiliki pipeline, setel statusnya ke IN_PROGRESS dan memblokir tindakan pipeline.
Menetapkan instans layanan apa pun yang akan dihapusDELETE_IN_PROGRESS.
Memblokir tindakan layanan.
Memblokir tindakan pada instance layanan yang ditandai untuk dihapus.
Membuat instance layanan baru.
Menghapus instance yang Anda daftarkan untuk dihapus.
Upaya untuk menghapus instans penghapusan yang gagal.
Setelah penambahan dan penghapusan selesai, siapkan kembali pipeline layanan (jika ada), atur layanan Anda ke ACTIVE dan aktifkan tindakan layanan dan pipeline.

AWS Proton mencoba untuk memediasi kembali mode kegagalan sebagai berikut.

Jika satu atau lebih instance layanan gagal dibuat, coba batalkan AWS Proton penyediaan semua instans layanan yang baru dibuat dan mengembalikannya spec ke status sebelumnya. Itu tidak menghapus instans layanan apa pun dan tidak mengubah pipeline dengan cara apa pun.
Jika satu atau lebih instance layanan gagal dihapus, sedi AWS Proton akan kembali pipeline tanpa instance yang dihapus. specDiperbarui untuk menyertakan instance yang ditambahkan dan untuk mengecualikan instance yang ditandai untuk dihapus.
Jika pipeline gagal menyediakan, rollback tidak dic oba dan layanan dan pipeline mencerminkan status pembaruan yang gagal.

Penandaan dan pengeditan layanan

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

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Tampilan

Delete