서비스 인스턴스를 업데이트 - AWS Proton

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

서비스 인스턴스를 업데이트

AWS Proton 서비스 인스턴스를 업데이트하고 업데이트를 취소하는 방법을 알아보세요.

서비스 인스턴스는 서비스에 속합니다. 서비스 편집, 생성 및 삭제 작업의 컨텍스트 내에서만 인스턴스를 생성하거나 삭제할 수 있습니다. 서비스에 인스턴스 추가 및 제거 방법에 대해 알아보려면 서비스 편집을 참조하세요.

다음 목록에 설명된 대로 서비스 인스턴스를 업데이트하는 데는 네 가지 모드가 있습니다. AWS CLI를 사용하는 경우 deployment-type 필드는 모드를 정의합니다. 콘솔을 사용할 때 이러한 모드는 서비스 인스턴스 세부 정보 페이지의 작업에서 드롭다운되는 편집 및 최신 마이너 버전 및 최신 메이저 버전으로 업데이트 작업에 매핑됩니다.

NONE

이 모드에서는 배포가 이루어지지 않습니다. 요청된 메타데이터 파라미터만 업데이트됩니다.

CURRENT_VERSION

이 모드에서는 서비스 인스턴스가 배포되고 사용자가 제공한 새 사양으로 업데이트됩니다. 요청된 파라미터만 업데이트됩니다. 이 deployment-type을 사용할 때 마이너 버전 또는 메이저 버전 파라미터를 포함하지 마십시오.

MINOR_VERSION

이 모드에서는 서비스 인스턴스가 기본적으로 현재 사용 중인 메이저 버전의 게시된, 권장되는 최신 마이너 버전으로 배포 및 업데이트됩니다. 현재 사용 중인 메이저 버전과 다른 마이너 버전을 지정할 수도 있습니다.

MAJOR_VERSION

이 모드에서는 기본적으로 현재 템플릿의 게시된 권장(최신) 메이저 버전 및 마이너 버전으로 서비스 인스턴스가 배포 및 업데이트됩니다. 사용 중인 메이저 버전보다 상위의 다른 메이저 버전과 마이너 버전을 지정할 수도 있습니다(선택 사항).

deploymentStatus이 IN_PROGRESS인 경우 서비스 인스턴스 업데이트 배포를 취소하려고 시도할 수 있습니다.AWS Proton에서 배배포를 취소하려고 시도합니다. 취소 성공은 보장되지 않습니다.

업데이트 배포를 취소하면 AWS Proton이 다음 단계에 나열된 대로 배포 취소를 시도합니다.

  • 배포 상태를 CANCELLING로 설정합니다.

  • IN_PROGRESS인 경우 진행 중인 배포를 중지하고 배포에 의해 생성된 모든 새 리소스를 삭제합니다.

  • 배포 상태를 CANCELLED로 설정합니다.

  • 리소스 상태를 배포가 시작되기 전의 상태로 되돌립니다.

서비스 인스턴스 배포를 취소하는 방법에 대한 자세한 내용은 AWS Proton API 참조에서 CancelServiceInstanceDeployment를 참조하세요.

콘솔 또는 AWS CLI을 사용하여 업데이트를 수행하거나 업데이트 배포를 취소할 수 있습니다.

AWS Management Console

다음 단계에 따라 콘솔을 사용하여 서비스 인스턴스를 업데이트합니다.

  1. AWS Proton 콘솔로 돌아가 탐색 창에서 서비스 인스턴스를 선택합니다.

  2. 서비스 인스턴스 목록에서 업데이트하려는 서비스 인스턴스의 이름을 선택합니다.

  3. 작업을 선택한 다음 업데이트 옵션 중 하나를 선택하고, 사양이나 작업을 업데이트하려면 편집을 선택한 다음 최신 마이너 버전으로 업데이트 또는 최신 메이저 버전으로 업데이트를 선택합니다.

  4. 양식을 작성하고 검토 페이지가 표시될 때까지 다음을 선택합니다.

  5. 편집 내용을 검토하고 업데이트를 선택합니다.

AWS CLI

CLI 예제 명령 및 응답에 표시된 대로 서비스 인스턴스를 새 마이너 버전으로 업데이트합니다.

서비스 인스턴스를 수정된 spec로 업데이트할 때 "${Proton::CURRENT_VAL}"를 사용하여 원본 spec에서 보존할 파라미터 값을 표시하는 데 사용할 수 있습니다(값이 spec에 존재하는 경우). 서비스 데이터 보기에 설명된 대로 get-service을 사용하여 서비스 인스턴스의 원본 spec를 봅니다.

다음은 spec에서 "${Proton::CURRENT_VAL}"를 사용하는 방법을 나타낸 예시입니다.

Spec:

proton: ServiceSpec

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

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

명령: 업데이트

$ aws proton update-service-instance \
    --name "instance-one" \
    --service-name "simple-svc" \
    --spec "file://service-spec.yaml" \
    --template-major-version "1" \
    --template-minor-version "1" \
    --deployment-type "MINOR_VERSION"

응답:

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

명령: 상태 가져오기 및 확인

$ aws proton get-service-instance \
    --name "instance-one" \
    --service-name "simple-svc"

응답:

{
    "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": "SUCCEEDED",
        "environmentName": "simple-env",
        "lastDeploymentAttemptedAt": "2021-04-02T21:38:00.823000+00:00",
        "lastDeploymentSucceededAt": "2021-04-02T21:38:00.823000+00:00",
        "name": "instance-one",
        "serviceName": "simple-svc",
        "spec": "proton: ServiceSpec\n\npipeline:\n  my_sample_pipeline_optional_input: \"abc\"\n  my_sample_pipeline_required_input: \"123\"\n\ninstances:\n  - name: \"instance-one\"\n    environment: \"simple-env\"\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: \"kls-simple-env\"\n    spec:\n      my_sample_service_instance_required_input: \"789\"\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "svc-simple"
    }
}
AWS Management Console

다음 단계에 표시된 대로 콘솔을 사용하여 서비스 인스턴스 배포를 취소합니다.

  1. AWS Proton 콘솔로 돌아가 탐색 창에서 서비스 인스턴스를 선택합니다.

  2. 서비스 인스턴스 목록에서 취소하려는 배포 업데이트가 있는 서비스 인스턴스의 이름을 선택합니다.

  3. 업데이트 배포 상태가 진행 중이면 서비스 인스턴스 세부 정보 페이지에서 작업을 선택한 다음 배포 취소를 선택합니다.

  4. 취소 확인을 요청하는 모달이 표시됩니다. 배포 취소를 선택합니다.

  5. 업데이트 배포 상태가 취소 중으로 설정된 다음 취소가 완료되면 취소됨으로 설정됩니다.

AWS CLI

다음 CLI 예제 명령 및 응답에 표시된 대로 새로운 마이너 버전 2로 IN_PROGRESS 서비스 인스턴스 배포 업데이트를 취소합니다.

이 예제에 사용된 템플릿에는 업데이트 배포가 성공하기 전에 취소가 시작되도록 대기 조건이 포함되어 있습니다.

명령: 취소

$ aws proton cancel-service-instance-deployment \
    --service-instance-name "instance-one" \
    --service-name "simple-svc"

응답:

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

명령: 상태 가져오기 및 확인

$ aws proton get-service-instance \
    --name "instance-one" \
    --service-name "simple-svc"

응답:

{
    "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": "CANCELLED",
        "deploymentStatusMessage": "User initiated cancellation.",
        "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\n\npipeline:\n  my_sample_pipeline_optional_input: \"abc\"\n  my_sample_pipeline_required_input: \"123\"\n\ninstances:\n  - name: \"instance-one\"\n    environment: \"simple-env\"\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: \"kls-simple-env\"\n    spec:\n      my_sample_service_instance_required_input: \"789\"\n",
        "templateMajorVersion": "1",
        "templateMinorVersion": "1",
        "templateName": "svc-simple"
    }
}