Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# AWS Proton contoh menggunakan AWS CLI
Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan AWS Command Line Interface with AWS Proton.
*Tindakan* merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.
Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.
**Topics**
+ [Tindakan](#actions)
## Tindakan
### `cancel-service-instance-deployment`
Contoh kode berikut menunjukkan cara menggunakan`cancel-service-instance-deployment`.
**AWS CLI**
**Untuk membatalkan penerapan instance layanan**
`cancel-service-instance-deployment`Contoh berikut membatalkan penerapan instance layanan.
```
aws proton cancel-service-instance-deployment \
--service-instance-name "instance-one" \
--service-name "simple-svc"
```
Output:
```
{
"serviceInstance": {
"arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
"createdAt": "2021-04-02T21:29:59.962000+00:00",
"deploymentStatus": "CANCELLING",
"environmentName": "simple-env",
"lastDeploymentAttemptedAt": "2021-04-02T21:45:15.406000+00:00",
"lastDeploymentSucceededAt": "2021-04-02T21:38:00.823000+00:00",
"name": "instance-one",
"serviceName": "simple-svc",
"spec": "proton: ServiceSpec\npipeline:\n my_sample_pipeline_optional_input: abc\n my_sample_pipeline_required_input: '123'\ninstances:\n- name: my-instance\n environment: MySimpleEnv\n spec:\n my_sample_service_instance_optional_input: def\n my_sample_service_instance_required_input: '456'\n- name: my-other-instance\n environment: MySimpleEnv\n spec:\n my_sample_service_instance_required_input: '789'\n",
"templateMajorVersion": "1",
"templateMinorVersion": "1",
"templateName": "svc-simple"
}
}
```
Untuk informasi selengkapnya, lihat [Memperbarui instance layanan](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-instance-update.html) *di Panduan Administrator AWS Proton* atau [Memperbarui instance layanan](https://docs.aws.amazon.com/proton/latest/userguide/ug-svc-instance-update.html) di Panduan Pengguna * AWS Proton*.
+ Untuk detail API, lihat [CancelServiceInstanceDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/cancel-service-instance-deployment.html)di *Referensi AWS CLI Perintah*.
### `cancel-service-pipeline-deployment`
Contoh kode berikut menunjukkan cara menggunakan`cancel-service-pipeline-deployment`.
**AWS CLI**
**Untuk membatalkan penerapan saluran pipa layanan**
`cancel-service-pipeline-deployment`Contoh berikut membatalkan penerapan pipeline layanan.
```
aws proton cancel-service-pipeline-deployment \
--service-name "simple-svc"
```
Output:
```
{
"pipeline": {
"arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/pipeline",
"createdAt": "2021-04-02T21:29:59.962000+00:00",
"deploymentStatus": "CANCELLING",
"lastDeploymentAttemptedAt": "2021-04-02T22:02:45.095000+00:00",
"lastDeploymentSucceededAt": "2021-04-02T21:39:28.991000+00:00",
"templateMajorVersion": "1",
"templateMinorVersion": "1",
"templateName": "svc-simple"
}
}
```
Untuk informasi selengkapnya, lihat [Memperbarui pipeline layanan](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-pipeline-update.html) *di Panduan Administrator AWS Proton* atau [Perbarui saluran layanan](https://docs.aws.amazon.com/proton/latest/userguide/ag-svc-pipeline-update.html) di Panduan Pengguna * AWS Proton*.
+ Untuk detail API, lihat [CancelServicePipelineDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/cancel-service-pipeline-deployment.html)di *Referensi AWS CLI Perintah*.
### `create-service`
Contoh kode berikut menunjukkan cara menggunakan`create-service`.
**AWS CLI**
**Untuk membuat layanan**
`create-service`Contoh berikut membuat layanan dengan pipa layanan.
```
aws proton create-service \
--name "MySimpleService" \
--template-name "fargate-service" \
--template-major-version "1" \
--branch-name "mainline" \
--repository-connection-arn "arn:aws:codestar-connections:region-id:account-id:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \
--repository-id "myorg/myapp" \
--spec file://spec.yaml
```
Isi dari `spec.yaml`:
```
proton: ServiceSpec
pipeline:
my_sample_pipeline_required_input: "hello"
my_sample_pipeline_optional_input: "bye"
instances:
- name: "acme-network-dev"
environment: "ENV_NAME"
spec:
my_sample_service_instance_required_input: "hi"
my_sample_service_instance_optional_input: "ho"
```
Output:
```
{
"service": {
"arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService",
"createdAt": "2020-11-18T19:50:27.460000+00:00",
"lastModifiedAt": "2020-11-18T19:50:27.460000+00:00",
"name": "MySimpleService",
"repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"repositoryId": "myorg/myapp",
"status": "CREATE_IN_PROGRESS",
"templateName": "fargate-service"
}
}
```
Untuk informasi selengkapnya, lihat [Membuat layanan](https://docs.aws.amazon.com/proton/latest/adminguide/ag-create-svc.html) *di Panduan Administrator AWS Proton* dan [Membuat layanan](https://docs.aws.amazon.com/proton/latest/userguide/ug-svc-create.html) di Panduan Pengguna * AWS Proton*.
+ Untuk detail API, lihat [CreateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/create-service.html)di *Referensi AWS CLI Perintah*.
### `delete-service`
Contoh kode berikut menunjukkan cara menggunakan`delete-service`.
**AWS CLI**
**Untuk menghapus layanan**
`delete-service`Contoh berikut menghapus layanan.
```
aws proton delete-service \
--name "simple-svc"
```
Output:
```
{
"service": {
"arn": "arn:aws:proton:region-id:123456789012:service/simple-svc",
"branchName": "mainline",
"createdAt": "2020-11-28T22:40:50.512000+00:00",
"description": "Edit by updating description",
"lastModifiedAt": "2020-11-29T00:30:39.248000+00:00",
"name": "simple-svc",
"repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"repositoryId": "myorg/myapp",
"status": "DELETE_IN_PROGRESS",
"templateName": "fargate-service"
}
}
```
Untuk informasi selengkapnya, lihat [Menghapus layanan](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-delete.html) *di Panduan Administrator AWS Proton*.
+ Untuk detail API, lihat [DeleteService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/delete-service.html)di *Referensi AWS CLI Perintah*.
### `get-service-instance`
Contoh kode berikut menunjukkan cara menggunakan`get-service-instance`.
**AWS CLI**
**Untuk mendapatkan detail instance layanan**
`get-service-instance`Contoh berikut mendapatkan data detail untuk instance layanan.
```
aws proton get-service-instance \
--name "instance-one" \
--service-name "simple-svc"
```
Output:
```
{
"serviceInstance": {
"arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
"createdAt": "2020-11-28T22:40:50.512000+00:00",
"deploymentStatus": "SUCCEEDED",
"environmentName": "simple-env",
"lastDeploymentAttemptedAt": "2020-11-28T22:40:50.512000+00:00",
"lastDeploymentSucceededAt": "2020-11-28T22:40:50.512000+00:00",
"name": "instance-one",
"serviceName": "simple-svc",
"spec": "proton: ServiceSpec\npipeline:\n my_sample_pipeline_optional_input: hello world\n my_sample_pipeline_required_input: pipeline up\ninstances:\n- name: instance-one\n environment: my-simple-env\n spec:\n my_sample_service_instance_optional_input: Ola\n my_sample_service_instance_required_input: Ciao\n",
"templateMajorVersion": "1",
"templateMinorVersion": "0",
"templateName": "svc-simple"
}
}
```
Untuk informasi selengkapnya, lihat [Melihat data layanan](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-view.html) *di Panduan Administrator AWS Proton* atau [Melihat data layanan](https://docs.aws.amazon.com/proton/latest/userguide/ug-svc-view.html) di Panduan Pengguna * AWS Proton*.
+ Untuk detail API, lihat [GetServiceInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/get-service-instance.html)di *Referensi AWS CLI Perintah*.
### `get-service`
Contoh kode berikut menunjukkan cara menggunakan`get-service`.
**AWS CLI**
**Untuk mendapatkan detail layanan**
`get-service`Contoh berikut mendapatkan data detail untuk suatu layanan.
```
aws proton get-service \
--name "simple-svc"
```
Output:
```
{
"service": {
"arn": "arn:aws:proton:region-id:123456789012:service/simple-svc",
"branchName": "mainline",
"createdAt": "2020-11-28T22:40:50.512000+00:00",
"lastModifiedAt": "2020-11-28T22:44:51.207000+00:00",
"name": "simple-svc",
"pipeline": {
"arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/pipeline/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"createdAt": "2020-11-28T22:40:50.512000+00:00",
"deploymentStatus": "SUCCEEDED",
"lastDeploymentAttemptedAt": "2020-11-28T22:40:50.512000+00:00",
"lastDeploymentSucceededAt": "2020-11-28T22:40:50.512000+00:00",
"spec": "proton: ServiceSpec\npipeline:\n my_sample_pipeline_required_input: hello\n my_sample_pipeline_optional_input: bye\ninstances:\n- name: instance-svc-simple\n environment: my-simple-env\n spec:\n my_sample_service_instance_required_input: hi\n my_sample_service_instance_optional_input: ho\n",
"templateMajorVersion": "1",
"templateMinorVersion": "1",
"templateName": "svc-simple"
},
"repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"repositoryId": "myorg/myapp",
"spec": "proton: ServiceSpec\npipeline:\n my_sample_pipeline_required_input: hello\n my_sample_pipeline_optional_input: bye\ninstances:\n- name: instance-svc-simple\n environment: my-simple-env\n spec:\n my_sample_service_instance_required_input: hi\n my_sample_service_instance_optional_input: ho\n",
"status": "ACTIVE",
"templateName": "svc-simple"
}
}
```
Untuk informasi selengkapnya, lihat [Melihat data layanan](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-view.html) *di Panduan Administrator AWS Proton* atau [Melihat data layanan](https://docs.aws.amazon.com/proton/latest/userguide/ug-svc-view.html) di Panduan Pengguna * AWS Proton*.
+ Untuk detail API, lihat [GetService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/get-service.html)di *Referensi AWS CLI Perintah*.
### `list-service-instances`
Contoh kode berikut menunjukkan cara menggunakan`list-service-instances`.
**AWS CLI**
**Contoh 1: Untuk mencantumkan semua instance layanan**
`list-service-instances`Contoh berikut mencantumkan instance layanan.
```
aws proton list-service-instances
```
Output:
```
{
"serviceInstances": [
{
"arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
"createdAt": "2020-11-28T22:40:50.512000+00:00",
"deploymentStatus": "SUCCEEDED",
"environmentArn": "arn:aws:proton:region-id:123456789012:environment/simple-env",
"lastDeploymentAttemptedAt": "2020-11-28T22:40:50.512000+00:00",
"lastDeploymentSucceededAt": "2020-11-28T22:40:50.512000+00:00",
"name": "instance-one",
"serviceName": "simple-svc",
"templateMajorVersion": "1",
"templateMinorVersion": "0",
"templateName": "fargate-service"
}
]
}
```
Untuk informasi selengkapnya, lihat [Melihat data instance layanan](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-instance-view.html) *di Panduan Administrator AWS Proton* atau [Melihat data instance layanan](https://docs.aws.amazon.com/proton/latest/userguide/ag-svc-instance-view.html) di Panduan Pengguna * AWS Proton*.
**Contoh 2: Untuk daftar contoh layanan yang ditentukan**
`get-service-instance`Contoh berikut mendapat instance layanan.
```
aws proton get-service-instance \
--name "instance-one" \
--service-name "simple-svc"
```
Output:
```
{
"serviceInstance": {
"arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
"createdAt": "2020-11-28T22:40:50.512000+00:00",
"deploymentStatus": "SUCCEEDED",
"environmentName": "simple-env",
"lastDeploymentAttemptedAt": "2020-11-28T22:40:50.512000+00:00",
"lastDeploymentSucceededAt": "2020-11-28T22:40:50.512000+00:00",
"name": "instance-one",
"serviceName": "simple-svc",
"spec": "proton: ServiceSpec\npipeline:\n my_sample_pipeline_optional_input: hello world\n my_sample_pipeline_required_input: pipeline up\ninstances:\n- name: instance-one\n environment: my-simple-env\n spec:\n my_sample_service_instance_optional_input: Ola\n my_sample_service_instance_required_input: Ciao\n",
"templateMajorVersion": "1",
"templateMinorVersion": "0",
"templateName": "svc-simple"
}
}
```
Untuk informasi selengkapnya, lihat [Melihat data instance layanan](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-instance-view.html) *di Panduan Administrator AWS Proton* atau [Melihat data instance layanan](https://docs.aws.amazon.com/proton/latest/userguide/ag-svc-instance-view.html) di Panduan Pengguna * AWS Proton*.
+ Untuk detail API, lihat [ListServiceInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/list-service-instances.html)di *Referensi AWS CLI Perintah*.
### `update-service-instance`
Contoh kode berikut menunjukkan cara menggunakan`update-service-instance`.
**AWS CLI**
**Untuk memperbarui instance layanan ke versi minor baru**
`update-service-instance`Contoh berikut memperbarui instance layanan ke versi minor baru dari template layanannya yang menambahkan instance baru bernama "my-other-instance" dengan input baru yang diperlukan.
```
aws proton update-service-instance \
--service-name "simple-svc" \
--spec "file://service-spec.yaml " \
--template-major-version "1" \
--template-minor-version "1" \
--deployment-type "MINOR_VERSION" \
--name "instance-one"
```
Isi dari `service-spec.yaml`:
```
proton: ServiceSpec
pipeline:
my_sample_pipeline_optional_input: "abc"
my_sample_pipeline_required_input: "123"
instances:
- name: "instance-one"
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"
```
Output:
```
{
"serviceInstance": {
"arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one",
"createdAt": "2021-04-02T21:29:59.962000+00:00",
"deploymentStatus": "IN_PROGRESS",
"environmentName": "arn:aws:proton:region-id:123456789012:environment/simple-env",
"lastDeploymentAttemptedAt": "2021-04-02T21:38:00.823000+00:00",
"lastDeploymentSucceededAt": "2021-04-02T21:29:59.962000+00:00",
"name": "instance-one",
"serviceName": "simple-svc",
"templateMajorVersion": "1",
"templateMinorVersion": "0",
"templateName": "svc-simple"
}
}
```
Untuk informasi selengkapnya, lihat [Memperbarui instance layanan](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-instance-update.html) *di Panduan Administrator AWS Proton* atau [Memperbarui instance layanan](https://docs.aws.amazon.com/proton/latest/userguide/ag-svc-instance-update.html) di Panduan Pengguna * AWS Proton*.
+ Untuk detail API, lihat [UpdateServiceInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/update-service-instance.html)di *Referensi AWS CLI Perintah*.
### `update-service-pipeline`
Contoh kode berikut menunjukkan cara menggunakan`update-service-pipeline`.
**AWS CLI**
**Untuk memperbarui pipeline layanan**
`update-service-pipeline`Contoh berikut memperbarui pipeline layanan ke versi minor baru dari template layanannya.
```
aws proton update-service-pipeline \
--service-name "simple-svc" \
--spec "file://service-spec.yaml" \
--template-major-version "1" \
--template-minor-version "1" \
--deployment-type "MINOR_VERSION"
```
Output:
```
{
"pipeline": {
"arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/pipeline/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"createdAt": "2021-04-02T21:29:59.962000+00:00",
"deploymentStatus": "IN_PROGRESS",
"lastDeploymentAttemptedAt": "2021-04-02T21:39:28.991000+00:00",
"lastDeploymentSucceededAt": "2021-04-02T21:29:59.962000+00:00",
"spec": "proton: ServiceSpec\n\npipeline:\n my_sample_pipeline_optional_input: \"abc\"\n my_sample_pipeline_required_input: \"123\"\n\ninstances:\n - name: \"my-instance\"\n environment: \"MySimpleEnv\"\n spec:\n my_sample_service_instance_optional_input: \"def\"\n my_sample_service_instance_required_input: \"456\"\n - name: \"my-other-instance\"\n environment: \"MySimpleEnv\"\n spec:\n my_sample_service_instance_required_input: \"789\"\n",
"templateMajorVersion": "1",
"templateMinorVersion": "0",
"templateName": "svc-simple"
}
}
```
Untuk informasi selengkapnya, lihat [Memperbarui pipeline layanan](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-pipeline-update.html) *di Panduan Administrator AWS Proton* atau [Perbarui saluran layanan](https://docs.aws.amazon.com/proton/latest/userguide/ag-svc-pipeline-update.html) di Panduan Pengguna * AWS Proton*.
+ Untuk detail API, lihat [UpdateServicePipeline](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/update-service-pipeline.html)di *Referensi AWS CLI Perintah*.
### `update-service`
Contoh kode berikut menunjukkan cara menggunakan`update-service`.
**AWS CLI**
**Untuk memperbarui layanan**
`update-service`Contoh berikut mengedit deskripsi layanan.
```
aws proton update-service \
--name "MySimpleService" \
--description "Edit by updating description"
```
Output:
```
{
"service": {
"arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService",
"branchName": "mainline",
"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": "myorg/myapp",
"status": "ACTIVE",
"templateName": "fargate-service"
}
}
```
Untuk informasi selengkapnya, lihat [Mengedit layanan](https://docs.aws.amazon.com/proton/latest/adminguide/ag-svc-update.html) *di Panduan Administrator AWS Proton* atau [Mengedit layanan](https://docs.aws.amazon.com/proton/latest/userguide/ug-svc-update.html) di Panduan Pengguna * AWS Proton*.
+ Untuk detail API, lihat [UpdateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/proton/update-service.html)di *Referensi AWS CLI Perintah*.