기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 제품 관리  템플릿을 메타데이터로 패키징하여 제품을 생성하고, 업데이트된 템플릿을 기반으로 새 버전을 생성하여 제품을 업데이트하고, 여러 제품을 함께 포트폴리오로 그룹화하여 사용자에게 배포합니다. 제품의 새 버전은 포트폴리오를 통해 제품에 액세스할 수 있는 모든 사용자에게 전파됩니다. 업데이트를 배포하는 경우 최종 사용자가 몇 번의 클릭만으로 기존의 프로비저닝된 제품을 업데이트할 수 있습니다. **Topics** + [제품 페이지 보기](#productmgmt-menu) + [제품 생성](productmgmt-cloudresource.md) + [포트폴리오에 제품 추가](catalogs_portfolios_adding-products.md) + [제품 업데이트](productmgmt-update.md) + [GitHub, GitHub Enterprise 또는 Bitbucket의 템플릿 파일에 제품 동기화](git-synced-sc-products.md) + [제품 삭제](productmgmt-delete.md) + [버전 관리](managing-versions.md) ## 제품 페이지 보기 AWS Service Catalog 관리자 콘솔의 제품 **목록 페이지에서 제품을** 관리합니다. ****제품 목록** 페이지를 보려면** 1. Service Quotas 콘솔([https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/))을 엽니다. 1. **제품 목록**을 선택합니다. # 제품 생성 AWS Service Catalog 관리자 콘솔의 제품 페이지에서 **제품을** 생성합니다. **참고** Terraform 제품을 만들려면 Terraform 프로비저닝 엔진 및 시작 역할을 포함한 추가 구성이 필요합니다. 자세한 내용은 [Terraform 제품 시작하기](getstarted-Terraform.md) 섹션을 참조하십시오. **새 AWS Service Catalog 제품을 생성하려면** 1. **제품 목록** 페이지로 이동합니다. 1. **제품 생성**을 선택한 다음 **제품 생성**을 선택합니다. 1. **제품 세부 정보** - 생성하려는 제품 유형을 선택할 수 있습니다. AWS Service Catalog Supports CloudFormation, Terraform Cloud 및 External(Terraform Community Edition 지원) 제품 유형을 선택합니다. 제품 세부 정보에는 목록 또는 세부 정보 페이지에서 제품을 검색하고 볼 때 나타나는 메타데이터도 포함됩니다. 다음을 입력합니다. + **제품 이름** - 제품 이름입니다. + **제품 설명** - 제품 목록에 설명이 표시되어 올바른 제품을 선택하는 데 도움이 됩니다. + **소유자** - 이 제품을 게시하는 개인 또는 조직입니다. 소유자는 IT 조직 또는 관리자의 이름일 수 있습니다. + **공급업체**(선택 사항) - 애플리케이션 게시자의 이름입니다. 이 필드를 통해 제품 목록을 정렬하여 제품을 더 쉽게 찾을 수 있습니다. 1. **버전 세부 정보를** 통해 템플릿 파일을 추가하고 제품을 빌드할 수 있습니다. 다음을 입력합니다. + **방법 선택** - 템플릿 파일을 추가하는 방법은 네 가지가 있습니다. + **로컬 템플릿 파일 사용** - 로컬 드라이브에서 CloudFormation 템플릿 또는 Terraform tar.gz 구성 파일을 업로드합니다. + **Amazon S3 URL 사용** - Amazon S3에 저장된 CloudFormation 템플릿 또는 Terraform tar.gz 구성 파일을 가리키는 URL을 지정합니다. Amazon S3 URL을 지정하는 경우에는 `https://`로 시작해야 합니다. + **외부 리포지토리 사용** - GitHub, GitHub Enterprise 또는 Bitbucket 코드 리포지토리를 지정합니다.를 AWS Service Catalog 사용하면 제품을 템플릿 파일에 동기화할 수 있습니다. Terraform 제품의 경우 템플릿 파일 형식은 Tar에 보관되고 Gzip으로 압축된 단일 파일이어야 합니다. + **기존 CloudFormation 스택 사용** - 기존 CloudFormation 스택의 ARN을 입력합니다. 이 방법은 Terraform Cloud 또는 외부 제품을 지원하지 않습니다. + **버전 이름**(선택 사항) - 제품 버전의 이름입니다(예: ‘v1’, ‘v2beta’). 공백은 사용할 수 없습니다. + **설명**(선택 사항) - 이 버전과 이전 버전의 차이점 등이 포함된 제품 버전에 대한 설명입니다. + **지침** - **제품 세부 정보** 페이지의 버전 탭에서 관리됩니다. 제품 생성 워크플로 중 제품 버전을 만들면 해당 버전에 대한 지침이 기본값으로 설정됩니다. 지침에 대한 자세한 내용은 [버전 관리](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/managing-versions.html) 섹션을 참조하십시오. 1. **지원 세부 정보**는 회사 내 조직을 식별하고 지원을 위한 연락 창구를 제공합니다. 다음을 입력합니다. + **이메일 연락처**(선택 사항) - 제품 관련 문제를 보고하기 위한 이메일 주소입니다. + **지원 링크**(선택 사항) - 사용자가 지원 정보 또는 파일 티켓을 찾을 수 있는 사이트 URL입니다. URL은 `http://` 또는 `https://`로 시작해야 합니다. 관리자는 지원 정보의 정확성과 액세스를 관리할 책임이 있습니다. + **지원 설명**(선택 사항) - **이메일 연락처** 및 **지원 링크**를 사용하는 방법에 대한 설명입니다. 1. **태그 관리** (선택 사항) - 태그를 사용하여 리소스를 분류하는 것 외에도 태그를 사용하여 이 리소스를 만들 권한을 인증할 수도 있습니다. 1. **제품 생성** - 양식을 작성했으면 **제품 생성**을 선택합니다. 몇 초 후 **제품 목록** 페이지에 제품이 표시됩니다. 제품을 보기 위해 브라우저를 새로 고쳐야 할 수도 있습니다. CodePipeline을 사용하여 제품 템플릿을에 배포하고 소스 리포지토리에서 변경한 내용을 전달하도록 파이프라인을 생성 AWS Service Catalog 및 구성할 수도 있습니다. 자세한 내용은[ 자습서: 배포 대상 파이프라인 생성을 참조하세요 AWS Service Catalog](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-S3-servicecatalog.html). CloudFormation 또는 Terraform 템플릿에서 파라미터 속성을 정의하고 프로비저닝 중에 해당 규칙을 적용할 수 있습니다. 이러한 속성은 최소 및 최대 길이, 최소 및 최대 값, 허용되는 값 및 값에 대한 정규식을 정의할 수 있습니다. 제공된 값이 파라미터 속성을 준수하지 않는 경우는 프로비저닝 중에 경고를 AWS Service Catalog 발행합니다. 파라미터 속성에 대한 자세한 내용은 *CloudFormation 사용 설명서*의 [파라미터](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html) 섹션을 참조하십시오. ## 문제 해결 Amazon S3 버킷에서 객체를 검색할 수 있는 권한이 있어야 합니다. 그렇지 않으면 제품을 시작하거나 업데이트할 때 오류가 발생할 수 있습니다. ``` Error: failed to process product version s3 access denied exception ``` 이 메시지가 표시되면 다음 버킷에서 객체를 검색할 수 있는 권한이 있는지 확인하십시오. + 프로비저닝 아티팩트 템플릿이 저장되는 버킷입니다. + "***cf-templates-\$1***"로 시작하고가 프로비저닝 아티팩트 템플릿을 AWS Service Catalog 저장하는 버킷입니다. + "***sc-\$1***"로 시작하고가 메타데이터를 AWS Service Catalog 저장하는 내부 버킷입니다. 계정에서는 이 버킷을 볼 수 없습니다. 다음 예제 정책은 앞서 언급한 버킷에서 객체를 검색하는 데 필요한 최소 권한을 보여줍니다. ``` { "Sid": "VisualEditor1", "Effect": "Allow", "Action": "s3:GetObject*", "Resource": [ "arn:aws:s3:::YOUR_TEMPLATE_BUCKET", "arn:aws:s3:::YOUR_TEMPLATE_BUCKET/*", "arn:aws:s3:::cf-templates-*", "arn:aws:s3:::cf-templates-*/*", "arn:aws:s3:::sc-*", "arn:aws:s3:::sc-*/*" ] } ``` # 포트폴리오에 제품 추가 포트폴리오 수에 제한 없이 제품을 추가할 수 있습니다. 제품이 업데이트되면 공유 포트폴리오를 포함해 해당 제품이 포함된 모든 포트폴리오가 새 버전을 자동으로 수신합니다. **포트폴리오에 카탈로그의 제품을 추가하려면** 1. **제품 목록** 페이지로 이동합니다. 1. 제품을 선택한 다음 **작업**을 선택합니다. 드롭다운 메뉴에서 **포트폴리오에 제품 추가**를 선택합니다. **포트폴리오에 *name-of-product* 추가** 페이지로 이동합니다. 1. 포트폴리오를 선택한 다음 **포트폴리오에 제품 추가**를 선택합니다. Terraform 제품을 포트폴리오에 추가할 때는 제품에 시작 제약이 필요합니다. 계정에서 IAM 역할을 선택하거나, IAM 역할 ARN을 입력하거나, 역할 이름을 입력해야 합니다. 역할 이름을 지정하면 계정이 시작 제약 조건을 사용할 때 계정에서 해당 이름을 가진 IAM 역할이 사용됩니다. 그러면 계정과 무관하게 시작 역할 제약 조건을 사용할 수 있으므로 공유 계정당 리소스를 더 적게 만들 수 있습니다. 세부 정보 및 지침은 [6단계: Terraform 제품에 시작 제약 추가](getstarted-launchconstraint-Terraform.md) 섹션을 참조하십시오. 포트폴리오에는 CloudFormation 및 Terraform 제품 유형이 혼합된 수많은 제품이 포함될 수 있습니다. # 제품 업데이트 제품의 템플릿을 업데이트해야 하는 경우 제품의 새 버전을 만듭니다. 새 제품 버전은 해당 제품이 들어 있는 포트폴리오에 액세스할 수 있는 모든 사용자에게 자동으로 제공됩니다. **참고** 기존 제품을 업데이트할 때는 제품 유형(CloudFormation 또는 Teraform)을 변경할 수 없습니다. 예를 들어 CloudFormation 제품을 업데이트하는 경우 기존 CloudFormation 템플릿을 Terraform tar.gz 구성 파일로 바꿀 수 없습니다. 기존 CloudFormation 템플릿 파일을 새 CloudFormation 템플릿 파일로 업데이트해야 합니다. 이전 제품 버전의 프로비저닝된 제품을 현재 실행하는 최종 사용자는 프로비저닝된 제품을 새 버전으로 업데이트할 수 있습니다. 새 버전의 제품을 사용할 수 있게 되면 사용자는 **프로비저닝된 제품 목록** 또는 **프로비저닝된 제품 세부 정보** 페이지에서 **프로비저닝된 제품 업데이트** 명령을 사용할 수 있습니다. 제품의 새 버전을 생성하기 전에 CloudFormation 또는 Terraform 엔진에서 제품 업데이트를 테스트하여 제대로 작동하는지 확인하는 것이 AWS Service Catalog 좋습니다. **새 제품 버전을 만들려면** 1. **제품 목록** 페이지로 이동합니다. 1. 업데이트하려는 제품을 선택합니다. *제품 세부 정보* 페이지로 이동합니다. 1. *제품 세부 정보* 페이지에서 **버전 ** 탭을 확장한 다음 **새 버전 생성**을 선택합니다. 1. **버전 세부 정보**에서 다음을 수행하십시오. + **템플릿 선택** - 템플릿 파일을 추가하는 방법은 네 가지가 있습니다. *로컬 템플릿 파일 사용* - 로컬 드라이브에서 CloudFormation 템플릿 또는 Terraform tar.gz 구성 파일을 업로드합니다. *Amazon S3 URL 사용* - Amazon S3에 저장된 CloudFormation 템플릿 또는 Terraform tar.gz 구성 파일을 가리키는 URL을 지정합니다. Amazon S3 URL을 지정하는 경우에는 https://로 시작해야 합니다. *외부 리포지토리 사용* - GitHub, GitHub Enterprise 또는 Bitbucket 코드 리포지토리를 지정합니다.를 AWS Service Catalog 사용하면 제품을 템플릿 파일에 동기화할 수 있습니다. Terraform 제품의 경우 템플릿 파일 형식은 Tar에 보관되고 Gzip으로 압축된 단일 파일이어야 합니다. *기존 CloudFormation 스택 사용* - 기존 CloudFormation 스택의 ARN을 입력합니다. 이 방법은 Terraform Cloud 또는 외부 제품을 지원하지 않습니다. + **버전 제목** - 제품 버전의 이름입니다(예: ‘v1’, ‘v2beta’). 공백은 사용할 수 없습니다. + **설명**(선택 사항) - 이 버전과 이전 버전의 차이점 등이 포함된 제품 버전에 대한 설명입니다. 1. **제품 버전 생성**을 선택합니다. CodePipeline을 사용하여 제품 템플릿을 배포할 파이프라인을 생성 및 구성 AWS Service Catalog하고 소스 리포지토리에 변경 사항을 전달할 수도 있습니다. 자세한 내용은 [자습서: 배포 대상 파이프라인 생성을 참조하세요 AWS Service Catalog](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-S3-servicecatalog.html). # GitHub, GitHub Enterprise 또는 Bitbucket의 템플릿 파일에 제품 동기화 AWS Service Catalog 를 사용하면 제품을 외부 리포지토리 공급자를 통해 관리되는 템플릿 파일에 동기화할 수 있습니다.는 이러한 유형의 템플릿 연결이 있는 제품을 *Git 동기화*된 제품으로 AWS Service Catalog 지칭합니다. 리포지토리의 옵션에는 GitHub, GitHub Enterprise 또는 Bitbucket 등이 있습니다. 외부 리포지토리 계정으로에 AWS 계정 권한을 부여한 후 새 AWS Service Catalog 제품을 생성하거나 기존 제품을 업데이트하여 리포지토리의 템플릿 파일에 동기화할 수 있습니다. 템플릿 파일을 변경하고 리포지토리에서 커밋하면(예: git-push 사용)는 변경 사항을 AWS Service Catalog 자동으로 감지하고 새 제품 버전(아티팩트)을 생성합니다. **Topics** + [제품을 외부 템플릿 파일에 동기화하는 데 필요한 권한](#required-perms-synced-repo) + [계정 연결 생성](#create-synced-product) + [Git 동기화 제품 연결 보기](#view-repo-sync) + [Git 동기화 제품 연결 업데이트](#update-repo-sync) + [Git 동기화 제품 연결 삭제](#delete-repo-sync) + [GitHub, GitHub Enterprise 또는 Bitbucket 템플릿 파일에 Terraform 제품 동기화](#git-synced-Terraform) + [AWS 리전 Git 동기화 제품에 대한 지원](git-sync-supported-regions.md) ## 제품을 외부 템플릿 파일에 동기화하는 데 필요한 권한 다음 AWS Identity and Access Management (IAM) 정책을 템플릿으로 사용하여 AWS Service Catalog 관리자가 제품을 외부 리포지토리의 템플릿 파일에 동기화할 수 있습니다. 이 정책에는 CodeConnections 및의 필수 권한이 모두 포함되어 있습니다 AWS Service Catalog. 에서는 아래 템플릿 정책을 복사하고 리포지토리 동기화 제품을 활성화할 때 [관리형 정책](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/security-iam-awsmanpol)도 사용할 AWS Service Catalog `AWSServiceCatalogAdminFullAccess` 것을 AWS Service Catalog 권장합니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "CodeStarAccess", "Effect": "Allow", "Action": [ "codestar-connections:UseConnection", "codestar-connections:PassConnection", "codestar-connections:CreateConnection", "codestar-connections:DeleteConnection", "codestar-connections:GetConnection", "codestar-connections:ListConnections", "codestar-connections:ListInstallationTargets", "codestar-connections:GetInstallationUrl", "codestar-connections:StartOAuthHandshake", "codestar-connections:UpdateConnectionInstallation", "codestar-connections:GetIndividualAccessToken" ], "Resource": "arn:aws:codestar-connections:*:*:connection/*" }, { "Sid": "CreateSLR", "Effect": "Allow", "Action": "iam:CreateServiceLinkedRole", "Resource": "arn:aws:iam::*:role/aws-service-role/sync.servicecatalog.amazonaws.com/AWSServiceRoleForServiceCatalogArtifactSync", "Condition": { "StringLike": { "iam:AWSServiceName": "sync.servicecatalog.amazonaws.com" } } } ] } ``` ------ ## 계정 연결 생성 템플릿 파일을 AWS Service Catalog 제품에 동기화하기 전에 일회성 account-to-account 연결을 생성하고 권한을 부여해야 합니다. 이 연결을 사용하여 원하는 템플릿 파일이 들어 있는 리포지토리의 세부 정보를 지정할 수 있습니다. AWS Service Catalog 콘솔, CodeConnections 콘솔, AWS Command Line Interface (CLI) 또는 CodeConnections APIs. 연결을 설정한 후 AWS Service Catalog 콘솔, AWS Service Catalog API 또는 CLI를 사용하여 동기화된 AWS Service Catalog 제품을 생성할 수 있습니다. AWS Service Catalog 관리자는 리포지토리 및 브랜치의 템플릿 파일을 기반으로 새 제품을 생성하거나 기존 AWS Service Catalog 제품을 업데이트할 수 있습니다. 리포지토리에서 변경 사항이 커밋되면는 변경 사항을 AWS Service Catalog 자동으로 감지하고 새 제품 버전을 생성합니다. 이전 제품 버전은 규정된 버전 제한까지 유지되며 **사용되지 않음** 상태가 할당됩니다. 또한는 연결이 생성된 후 서비스 연결 역할(SLR)을 AWS Service Catalog 자동으로 생성합니다. 이러한 SLR을 통해 AWS Service Catalog 는 리포지토리에 커밋된 모든 템플릿 파일 변경 내용을 감지할 수 있습니다. 또한 SLR을 사용하면 AWS Service Catalog 가 동기화된 제품에 대한 새 제품 버전을 자동으로 생성할 수 있습니다. SLR 권한 및 기능에 대한 자세한 내용은 [AWS Service Catalog의 서비스 연결 역할](#required-perms-synced-repo) 섹션을 참조하십시오. **새 Git 동기화 제품을 만들려면** 1. 왼쪽 탐색 창에서 **제품 목록**을 선택한 다음, **제품 생성**을 선택합니다. 1. **제품 세부 정보**를 입력합니다. 1. 버전 세부 정보에서 **공급자를 사용하여 코드 리포지토리 지정을 AWS CodeStar **선택한 다음 **새 AWS CodeStar 연결 생성** 링크를 선택합니다. 1. 연결을 만든 후 연결 목록을 새로 고친 다음, 새 연결을 선택합니다. **리포지토리**, **브랜치**, **템플릿 파일 경로**를 비롯한 리포지토리 세부 정보를 지정합니다. Terraform 구성 파일 사용에 대한 자세한 내용은 [GitHub, GitHub Enterprise 또는 Bitbucket 템플릿 파일에 Terraform 제품 동기화](#git-synced-Terraform)을 참조하십시오. 1. (새 AWS Service Catalog 제품 리소스를 생성할 때 선택 사항) **지원 세부 정보** 섹션에서 제품에 대한 메타데이터를 추가합니다. 1. (새 AWS Service Catalog 제품 리소스를 생성할 때 선택 사항) **태그** 섹션에서 **새 태그 추가**를 선택하고 **키** 및 **값** 페어를 입력합니다. 1. **새 프로젝트 생성**을 선택합니다. **Git 동기화 제품을 여러 개 만들려면** 1. AWS Service Catalog 콘솔 왼쪽 탐색 패널에서 **제품 목록을** 선택한 다음 **여러 git 관리형 제품 생성을** 선택합니다. 1. **일반 제품 세부 정보**를 입력합니다. 1. 외부 리포지토리 세부 정보에서 **AWS CodeStar 연결**을 선택한 다음 **리포지토리**와 **브랜치**를 지정합니다. 1. 제품 추가 창에서 **템플릿 파일 경로**와 **제품 이름**을 입력합니다. **새 항목 추가**를 선택하고 원하는 대로 제품을 계속 추가합니다. 1. 원하는 제품을 모두 추가한 후 **제품 대량 생성**을 선택합니다. **기존 AWS Service Catalog 제품을 외부 리포지토리에 연결하려면** 1. AWS Service Catalog 콘솔 왼쪽 탐색 패널에서 **제품 목록을** 선택한 다음 **제품을 외부 리포지토리에 연결을** 선택합니다. 1. 제품 선택 페이지에서 외부 리포지토리에 연결할 제품을 선택하고 **다음**을 선택합니다. 1. 소스 세부 정보 지정 페이지에서 기존 AWS CodeStar 연결을 선택한 다음 **리포지토리**, **브랜치** 및 **템플릿 파일 경로를** 지정합니다. 1. **다음**을 선택합니다. 1. 검토 및 제출 페이지에서 연결 세부 정보를 확인한 다음 **제품을 외부 리포지토리에 연결**을 선택합니다. ## Git 동기화 제품 연결 보기 AWS Service Catalog 콘솔, API 또는 AWS CLI 를 사용하여 리포지토리 연결 세부 정보를 볼 수 있습니다. 템플릿 파일에 연결된 AWS Service Catalog 제품의 경우 리포지토리 연결 및 마지막 **동기화 상태에서** 템플릿이 제품과 마지막으로 동기화된 시간에 대한 정보를 검색할 수 있습니다. **참고** 제품 수준에서 리포지토리 정보와 **마지막 동기화 상태**를 볼 수 있습니다. 리포지토리 세부 정보를 보려면 CodeConnections APIs에 IAM 권한이 있어야 합니다. 이러한 IAM [권한에 필요한 정책에 대한 자세한 내용은 AWS Service Catalog 제품을 템플릿 파일에 동기화하는 데](#required-perms-synced-repo) 필요한 권한을 참조하세요. **를 사용하여 연결 및 리포지토리 세부 정보를 보려면 AWS Management Console** 1. 왼쪽 탐색 창에서 **제품 목록**을 선택합니다. 1. 목록에서 제품을 선택합니다. 1. **제품** 페이지에서 **제품 소스 세부 정보** 섹션으로 이동합니다. 1. 제품 버전의 소스 수정 ID를 보려면 **마지막으로 생성된 버전** 링크를 선택합니다. **버전 세부 정보** 섹션에는 소스 수정 ID가 표시됩니다. **를 사용하여 연결 및 리포지토리 세부 정보를 보려면 AWS CLI** 에서 다음 명령을 AWS CLI실행합니다. `$ aws servicecatalog describe-product-as-admin` `$ aws servicecatalog describe-provisioning-artifact` `$ aws servicecatalog search-product-as-admin` `$ aws servicecatalog list-provisioning-artifacts` ## Git 동기화 제품 연결 업데이트 AWS Service Catalog 콘솔, AWS Service Catalog API 또는를 사용하여 기존 계정 연결 및 Git 동기화 제품을 업데이트할 수 있습니다 AWS CLI. 기존 AWS Service Catalog 제품을 템플릿 파일에 연결하는 방법을 알아보려면 [ 새 Git 동기화 제품 연결 생성을](#create-synced-product) 참조하세요. **기존 제품을 Git 동기화 제품으로 업데이트하려면** 1. 왼쪽 탐색 패널에서 **제품 목록**을 선택하고 다음 옵션 중 하나를 선택합니다. + **단일 제품**을 업데이트하려면 제품을 선택하고 **제품 소스 세부 정보** 섹션으로 이동한 다음 **세부 정보 편집**을 선택합니다. + **여러 제품**을 업데이트하려면 **외부 리포지토리에 제품 연결**을 선택하고 제품을 10개까지 선택한 후 **다음**을 선택합니다. 1. **제품 소스 세부 정보** 섹션에서 다음 업데이트를 수행합니다. + 연결을 지정합니다. + 리포지토리를 지정합니다. + 브랜치를 지정합니다. + 템플릿 파일의 이름을 지정합니다. 1. **변경 사항 저장**을 선택합니다. **참고** 외부 리포지토리에 아직 연결되지 않은 제품의 경우, 제품을 선택한 후 제품 정보 페이지 상단의 경고에 표시되는 **외부 리포지토리에 연결** 옵션을 사용할 수 있습니다. AWS Service Catalog 콘솔 또는를 사용하여 AWS CLI + 기존 AWS Service Catalog 제품을 외부 리포지토리의 템플릿 파일에 연결 + 제품 이름, 설명 및 태그를 포함한 제품 메타데이터를 업데이트합니다. + 이전에 연결한 AWS Service Catalog 제품에 대한 연결을 재구성합니다(다른 리포지토리 소스를 사용하도록 동기화 업데이트). **AWS Service Catalog 콘솔을 사용하여 연결 및 리포지토리 세부 정보를 업데이트하려면** 1. AWS Service Catalog 콘솔 왼쪽 탐색 패널에서 **제품 목록을** 선택한 다음 외부 리포지토리에 현재 연결된 제품을 선택합니다. 1. **제품 소스 세부 정보** 섹션에서 **제품 소스 편집**을 선택합니다. 1. **제품 소스 세부 정보** 섹션에서 원하는 새 리포지토리를 지정합니다. 1. **변경 사항 저장**을 선택합니다. **를 사용하여 연결 및 리포지토리 세부 정보를 업데이트하려면 AWS CLI** 에서 `$ aws servicecatalog update-product` 및 `$ aws servicecatalog update-provisioning-artifact` 명령을 AWS CLI 실행합니다. ## Git 동기화 제품 연결 삭제 AWS Service Catalog 콘솔, CodeConnections API 또는를 사용하여 AWS Service Catalog 제품과 템플릿 파일 간의 연결을 삭제할 수 있습니다 AWS CLI. 템플릿 파일에서 제품의 연결을 해제하면 동기화된 AWS Service Catalog 제품이 정기적으로 관리되는 제품으로 전환됩니다. 제품 연결을 끊은 후 템플릿 파일을 변경하고 이전에 연결된 리포지토리에서 커밋하면 변경 내용이 반영되지 *않습니다*. AWS Service Catalog 제품을 외부 리포지토리의 템플릿 파일에 다시 연결하려면 [연결 및 동기화된 AWS Service Catalog 제품 업데이트를 참조하세요](). **AWS Service Catalog 콘솔을 사용하여 Git 동기화 제품의 연결을 해제하려면** 1. 의 왼쪽 탐색 패널에서 **제품 목록을** AWS Management Console선택합니다. 1. 목록에서 제품을 선택합니다. 1. **제품** 페이지에서 **제품 소스 세부 정보** 섹션으로 이동합니다. 1. **연결 해제**를 선택합니다. 1. 작업을 확인한 다음 **연결 해제**를 선택합니다. **를 사용하여 Git 동기화 제품의 연결을 해제하려면 AWS CLI** 에서 `$ aws servicecatalog update-product` 명령을 AWS CLI실행합니다. `ConnectionParameters` 입력에서 지정된 연결을 제거합니다. **CodeConnections API 또는를 사용하여 연결을 삭제하려면 AWS CLI** CodeConnections API 또는에서 `$ aws codestar-connections delete-connection` 명령을 AWS CLI실행합니다. ## GitHub, GitHub Enterprise 또는 Bitbucket 템플릿 파일에 Terraform 제품 동기화 Terraform 구성 파일을 사용하여 Git 동기화 제품을 만들 때 파일 경로는 tar.gz 형식만 허용합니다. Terraform 폴더 형식은 파일 경로에 사용할 수 없습니다. # AWS 리전 Git 동기화 제품에 대한 지원 AWS Service Catalog 는 아래 표에 표시된 AWS 리전 대로에서 Git 동기화 produtcs를 지원합니다. **** | AWS 리전 이름 | AWS 리전 자격 증명 | Git 동기화 제품에 대한 지원 | | --- | --- | --- | | 미국 동부(버지니아 북부) | us-east-1 | 예 | | 미국 동부(오하이오) | us-east-2 | 예 | | 미국 서부(캘리포니아 북부) | us-west-1 | 예 | | 미국 서부(오리건) | us-west-2 | 예 | | 아프리카(케이프타운) | af-south-1 | 아니요 | | Asia Pacific (Hong Kong) | ap-east-1 | 아니요 | | 아시아 태평양(자카르타) | ap-southeast-3 | 아니요 | | 아시아 태평양(뭄바이) | ap-south-1 | 예 | | 아시아 태평양(오사카) | ap-northeast-3 | 아니요 | | 아시아 태평양(서울) | ap-northeast-2 | 예 | | 아시아 태평양(싱가포르) | ap-southeast-1 | 예 | | 아시아 태평양(시드니) | ap-southeast-2 | 예 | | 아시아 태평양(도쿄) | ap-northeast-1 | 예 | | 캐나다(중부) | ca-central-1 | 예 | | 유럽(프랑크푸르트) | eu-central-1 | 예 | | 유럽(아일랜드) | eu-west-1 | 예 | | 유럽(런던) | eu-west-2 | 예 | | 유럽(밀라노) | eu-south-1 | 아니요 | | 유럽(파리) | eu-west-3 | 예 | | 유럽(스톡홀름) | eu-north-1 | 예 | | 중동(바레인) | me-south-1 | 아니요 | | 남아메리카(상파울루) | sa-east-1 | 예 | | AWS GovCloud(미국 동부) | us-gov-east-1 | 아니요 | | AWS GovCloud(미국 서부) | us-gov-west-1 | 아니요 | # 제품 삭제 제품을 삭제하면는 제품이 포함된 모든 포트폴리오에서 모든 제품 버전을 AWS Service Catalog 제거합니다. AWS Service Catalog 를 사용하면 AWS Service Catalog 콘솔 또는를 사용하여 제품을 삭제할 수 있습니다 AWS CLI. 제품을 성공적으로 삭제하려면 먼저 제품과 관련된 모든 리소스의 연결을 끊어야 합니다. 제품 리소스 연결의 예로는 포트폴리오 연결, 예산, TagOption, 서비스 작업 등이 있습니다. **중요** 삭제한 제품은 복구할 수 없습니다. **AWS Service Catalog 콘솔을 사용하여 제품을 삭제하려면** 1. **포트폴리오** 페이지로 이동하여 삭제하려는 제품이 포함된 포트폴리오를 선택합니다. 1. 삭제하려는 제품을 선택한 다음 제품 창의 오른쪽 상단에서 **삭제**를 선택합니다. 1. *관련 리소스가 없는* 제품의 경우 텍스트 상자에 **삭제**를 입력하여 삭제하려는 제품을 확인한 다음 **삭제**를 선택합니다. *관련 리소스가 있는* 제품의 경우에는 4단계를 진행합니다. 1. **제품 삭제** 창에서 제품의 모든 관련 리소스가 표시된 **연결** 테이블을 검토합니다. 제품을 삭제할 때 이러한 리소스의 연결을 해제하려고 AWS Service Catalog 시도합니다. 1. 텍스트 상자에 **삭제**를 입력하여 제품 삭제를 관련 리소스를 모두 제거할 것인지 확인합니다. 1. **연결 해제 및 삭제**를 선택합니다. AWS Service Catalog 가 제품의 모든 리소스를 연결 해제할 수 없는 경우 제품이 삭제되지 않습니다. **제품 삭제** 창에는 실패한 연결 해제 시도 횟수와 각 실패에 대한 설명이 표시됩니다. 제품 삭제 시 리소스 연결 해제 실패 문제를 해결하는 방법에 대한 자세한 내용은 아래의 *제품 삭제 시 실패한 리소스 연결 해제 해결* 섹션을 참조하십시오. **Topics** + [를 사용하여 제품 삭제 AWS CLI](product-delete-cli.md) + [제품 삭제 시 리소스 연결 해제 실패 문제 해결하기](product-delete-exception.md) # 를 사용하여 제품 삭제 AWS CLI AWS Service Catalog 를 사용하면 [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) (AWS CLI)를 사용하여 포트폴리오에서 제품을 삭제할 수 있습니다. AWS CLI 는 명령줄 셸의 명령을 사용하여 AWS 서비스와 상호 작용할 수 있는 오픈 소스 도구입니다. AWS Service Catalog force-delete 함수에는 자주 사용하는 명령이나 스크립트를 단축 AWS CLI 하기 위해에서 생성할 수 있는 바로 가기인 [AWS CLI 별칭](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-alias.html)이 필요합니다. ## 사전 조건 + AWS CLI를 설치하고 구성합니다. 자세한 내용은 [AWS CLI의 최신 버전 설치 또는 업데이트](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 및 [구성 기본](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html)을 참조하십시오. 최소 AWS CLI 버전 1.11.24 또는 2.0.0을 사용합니다. + 제품 CLI 별칭 삭제에는 bash 호환 터미널과 JQ 명령줄 JSON 프로세서가 필요합니다. 명령줄 JSON 프로세서 설치에 대한 자세한 내용은 [jq 다운로드](https://stedolan.github.io/jq/download/) 섹션을 참조하십시오. + `Disassociation` API 호출을 일괄 처리할 AWS CLI 별칭을 생성하여 단일 명령으로 제품을 삭제할 수 있습니다. 제품을 성공적으로 삭제하려면 먼저 제품과 관련된 모든 리소스의 연결을 끊어야 합니다. 제품 리소스 연결의 예로는 포트폴리오 연결, 예산, TagOption, 서비스 작업 등이 있습니다. CLI를 사용하여 제품을 삭제할 때 CLI `force-delete-product` 별칭을 사용하면 `Disassociate` API를 호출하여 `DeleteProduct` API를 차단하는 모든 리소스의 연결을 끊을 수 있습니다. 이렇게 하면 개별 연결 해제를 위해 별도의 호출을 하지 않아도 됩니다. **참고** 아래 절차에 표시된 파일 경로는 이러한 작업을 수행하는 데 사용하는 운영 체제에 따라 다를 수 있습니다. ## AWS Service Catalog 제품을 삭제하기 위한 AWS CLI 별칭 생성 AWS CLI 를 사용하여 AWS Service Catalog 제품을 삭제할 때 CLI `force-delete-product`별칭을 사용하면 `Disassociate` API를 호출하여 `DeleteProduct` 호출을 방해하는 모든 리소스의 연결을 해제할 수 있습니다. **AWS CLI 구성 폴더에 `alias` 파일 생성** 1. AWS CLI 콘솔에서 구성 폴더로 이동합니다. 기본적으로 구성 폴더 경로는 Linux 및 macOS의 `~/.aws/` 또는 Windows `%USERPROFILE%\.aws\`에 있습니다. 1. 파일 탐색을 사용하거나 선호하는 터미널에 다음 명령을 입력하여 이름을 `cli`로 지정한 하위 폴더를 생성합니다. ``` $ mkdir -p ~/.aws/cli ``` 결과로 생성되는 `cli` 폴더의 기본 경로는 Linux 및 macOS의 `~/.aws/cli/` 또는 Windows의 `%USERPROFILE%\.aws\cli`입니다. 1. 새로운 `cli` 폴더에서 파일 확장명 없이 이름이 `alias`인 텍스트 파일을 생성합니다. 파일 탐색을 사용하거나 선호하는 터미널에 다음 명령을 입력하여 `alias` 파일을 생성할 수 있습니다. ``` $ touch ~/.aws/cli/alias ``` 1. 첫 번째 줄에 `[toplevel]`을 입력합니다. 1. 파일을 저장합니다. 그다음 별칭 스크립트를 파일에 수동으로 붙여넣거나 터미널 창에서 명령을 사용하여 force-delete-product 별칭을 `alias` 파일에 추가할 수 있습니다. **force-delete-product 별칭을 `alias` 파일에 수동으로 추가하기** 1. AWS CLI 콘솔에서 AWS CLI 구성 폴더로 이동하여 `alias` 파일을 엽니다. 1. 파일의 `[toplevel]` 줄 아래에 다음 코드 별칭을 입력합니다. ``` [command servicecatalog] force-delete-product = !f() { if [ "$#" -ne 1 ]; then echo "Illegal number of parameters" exit 1 fi if [[ "$1" != prod-* ]]; then echo "Please provide a valid product id." exit 1 fi productId=$1 describeProductAsAdminResponse=$(aws servicecatalog describe-product-as-admin --id $productId) listPortfoliosForProductResponse=$(aws servicecatalog list-portfolios-for-product --product-id $productId) tagOptions=$(echo "$describeProductAsAdminResponse" | jq -r '.TagOptions[].Id') budgetName=$(echo "$describeProductAsAdminResponse" | jq -r '.Budgets[].BudgetName') portfolios=$(echo "$listPortfoliosForProductResponse" | jq -r '.PortfolioDetails[].Id') provisioningArtifacts=$(echo "$describeProductAsAdminResponse" | jq -r '.ProvisioningArtifactSummaries[].Id') provisioningArtifactServiceActionAssociations=() for provisioningArtifactId in $provisioningArtifacts; do listServiceActionsForProvisioningArtifactResponse=$(aws servicecatalog list-service-actions-for-provisioning-artifact --product-id $productId --provisioning-artifact-id $provisioningArtifactId) serviceActions=$(echo "$listServiceActionsForProvisioningArtifactResponse" | jq -r '[.ServiceActionSummaries[].Id] | join(",")') if [[ -n "$serviceActions" ]]; then provisioningArtifactServiceActionAssociations+=("${provisioningArtifactId}:${serviceActions}") fi done echo "Before deleting a product, the following associated resources must be disassociated. These resources will not be deleted. This action may take some time, depending on the number of resources being disassociated." echo "Portfolios:" for portfolioId in $portfolios; do echo "\t${portfolioId}" done echo "Budgets:" if [[ -n "$budgetName" ]]; then echo "\t${budgetName}" fi echo "Tag Options:" for tagOptionId in $tagOptions; do echo "\t${tagOptionId}" done echo "Service Actions on Provisioning Artifact:" for association in "${provisioningArtifactServiceActionAssociations[@]}"; do echo "\t${association}" done read -p "Are you sure you want to delete ${productId}? y,n " if [[ ! $REPLY =~ ^[Yy]$ ]]; then exit fi for portfolioId in $portfolios; do echo "Disassociating ${portfolioId}" aws servicecatalog disassociate-product-from-portfolio --product-id $productId --portfolio-id $portfolioId done if [[ -n "$budgetName" ]]; then echo "Disassociating ${budgetName}" aws servicecatalog disassociate-budget-from-resource --budget-name "$budgetName" --resource-id $productId fi for tagOptionId in $tagOptions; do echo "Disassociating ${tagOptionId}" aws servicecatalog disassociate-tag-option-from-resource --tag-option-id $tagOptionId --resource-id $productId done for association in "${provisioningArtifactServiceActionAssociations[@]}"; do associationPair=(${association//:/ }) provisioningArtifactId=${associationPair[0]} serviceActionsList=${associationPair[1]} serviceActionIds=${serviceActionsList//,/ } for serviceActionId in $serviceActionIds; do echo "Disassociating ${serviceActionId} from ${provisioningArtifactId}" aws servicecatalog disassociate-service-action-from-provisioning-artifact --product-id $productId --provisioning-artifact-id $provisioningArtifactId --service-action-id $serviceActionId done done echo "Deleting product ${productId}" aws servicecatalog delete-product --id $productId }; f ``` 1. 파일을 저장합니다. **터미널 창을 사용하여 force-delete-product 별칭을 `alias` 파일에 추가합니다.** 1. 터미널 창을 열고 다음 명령을 실행합니다. `$ cat >> ~/.aws/cli/alias` 1. 별칭 스크립트를 터미널 창에 붙여넣은 다음 *Ctrl\$1D*를 눌러 `cat` 명령을 종료합니다. **force-delete-product 별칭 호출** 1. 터미널 창에서 다음 명령을 실행하여 제품 별칭 삭제를 호출합니다. `$ aws servicecatalog force-delete-product {product-id} ` 아래 예제는 `force-delete-product` 별칭 명령과 그에 따른 응답을 보여줍니다. ``` $ aws servicecatalog force-delete-product prod-123 ``` ``` Before deleting a product, the following associated resources must be disassociated. These resources will not be deleted. This action may take some time, depending on the number of resources being disassociated. Portfolios: port-123 Budgets: budgetName Tag Options: tag-123 Service Actions on Provisioning Artifact: pa-123:act-123 Are you sure you want to delete prod-123? y,n ``` 1. `y`를 입력하여 제품 삭제를 확인합니다. 제품을 성공적으로 삭제하면 터미널 창에 다음 결과가 표시됩니다. ``` Disassociating port-123 Disassociating budgetName Disassociating tag-123 Disassociating act-123 from pa-123 Deleting product prod-123 ``` ## 추가 리소스 별칭 AWS CLI사용 및 AWS Service Catalog 제품 삭제에 대한 자세한 내용은 다음 리소스를 참조하세요. + *AWS Command Line Interface (CLI)* 사용 설명서의 [AWS CLI 별칭 생성 및 사용](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-alias.html). + [AWS CLI 별칭 리포](https://github.com/awslabs/awscli-aliases)지토리 git 리포지토리. + [AWS Service Catalog 제품 삭제](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/productmgmt-delete.html). + [AWS re:Invent 2016: YouTube의 유효 AWS CLI 사용자](https://youtu.be/Xc1dHtWa9-Q?t=1593). *YouTube* # 제품 삭제 시 리소스 연결 해제 실패 문제 해결하기 리소스 연결 해제 예외로 인해 이전 [제품 삭제](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/productmgmt-delete.html) 시도가 실패한 경우 아래 예외 목록과 해결 방법을 검토하십시오. **참고** 리소스 연결 해제 실패 메시지를 받기 전에 **제품 삭제** 창을 닫은 경우, 진행 중인 *제품 삭제* 섹션의 1\$13단계에 따라 창을 다시 열 수 있습니다. **리소스 연결 해제 실패 문제를 해결하려면** **제품 삭제** 창에서 연결 테이블 **상태** 열을 검토하십시오. 리소스 연결 해제 실패 예외와 제안된 해결 방법을 알아봅니다. **** | 상태 예외 유형 | 원인 | 해결 방법 | | --- | --- | --- | | Product prod-\$1\$1\$1\$1 | AWS Service Catalog 는 제품에 여전히 연결된 TagOptions, 예산, 연결된 작업이 ProvisioningArtifact 있는 하나 이상의가 있거나, 제품이 여전히 포트폴리오에 할당되어 있거나, 제품에 사용자가 있거나, 제품에 제약이 있기 때문에 제품을 삭제할 수 없습니다. | 제품 삭제를 다시 시도하십시오. | | 사용자: username에게 다음을 수행할 권한이 부여되지 않았습니다. | 제품을 삭제하려는 사용자에게는 제품 리소스의 연결을 끊는 데 필요한 권한이 없습니다. | AWS Service Catalog 현재 연결 해제 권한이 없는 제품 리소스의 연결 해제에 대한 자세한 내용은 계정 관리자에게 문의하는 것이 좋습니다. | # 버전 관리 제품을 생성할 때 제품 버전을 지정합니다. 제품 버전은 언제든지 업데이트할 수 있습니다. 버전에는 CloudFormation 템플릿, 제목, 설명, 상태 및 지침이 있습니다. ## 버전 상태 버전은 다음 세 가지 상태 중 하나일 수 있습니다. + **활성** - 활성 버전이 버전 목록에 표시되어 사용자가 이를 시작할 수 있습니다. + **비활성** - 비활성 버전은 버전 목록에서 숨김 처리되어 보이지 않습니다. 프로비저닝된 기존 제품 중 이 버전에서 시작된 것은 영향을 받지 않습니다. + **삭제됨** - 삭제된 버전은 버전 목록에서 제거됩니다. 버전 삭제는 실행 취소할 수 없습니다. ## 버전 지침 버전 지침을 설정하여 최종 사용자에게 제품 버전에 대한 정보를 제공할 수 있습니다. 버전 지침은 활성 제품 버전에만 영향을 줍니다. 버전 지침에는 두 가지 옵션이 있습니다. + **없음** - 기본적으로 제품 버전에는 지침이 없습니다. 최종 사용자는 해당 버전을 사용하여 프로비저닝된 제품을 업데이트하고 실행할 수 있습니다. + **사용되지 않음** - 사용자는 더 이상 사용되지 않는 제품 버전을 사용하여 프로비저닝된 새 제품을 시작할 수 없습니다. 이전에 시작된 프로비저닝된 제품이 현재 더 이상 사용되지 않는 버전을 사용하는 경우, 사용자는 기존 버전 또는 새 버전을 사용하여 프로비저닝된 해당 제품을 업데이트하는 것만 가능합니다. ## 버전 업데이트 제품을 생성할 때 제품 버전을 지정합니다. 또한 버전은 언제든지 업데이트할 수 있습니다. 제품 생성에 대한 자세한 내용은 [제품 생성](productmgmt-cloudresource.md) 단원을 참조하십시오. **제품 버전을 업데이트하려면** 1. AWS Service Catalog 콘솔에서 **제품을** 선택합니다. 1. 제품 목록에서 버전을 업데이트할 제품을 선택합니다. 1. **제품 세부 정보** 페이지에서 **버전** 탭을 선택한 다음 업데이트할 버전을 선택합니다. 1. **버전 세부 정보** 페이지에서 제품 버전을 편집한 다음 **변경 사항 저장**을 선택합니다.