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

# AWS Service Catalog 배포 작업 참조
<a name="action-reference-ServiceCatalog"></a>

 AWS Service Catalog 작업을 사용하여 파이프라인을 사용하여 템플릿을 배포합니다. Service Catalog에서 생성한 리소스 템플릿입니다.

## 작업 유형
<a name="action-reference-ServiceCatalog-type"></a>
+ 범주: `Deploy`
+ 소유자: `AWS`
+ 공급자: `ServiceCatalog`
+ 버전: `1`

## 구성 파라미터
<a name="action-reference-ServiceCatalog-config"></a>

**TemplateFilePath**  
필수 항목 여부: 예  
소스 위치에 있는 리소스 템플릿의 파일 경로입니다.

**ProductVersionName**  
필수 항목 여부: 예  
Service Catalog의 제품 버전입니다.

**ProductType**  
필수 항목 여부: 예  
Service Catalog의 제품 유형입니다.

**ProductId**  
필수 항목 여부: 예  
Service Catalog의 제품 ID입니다.

**ProductVersionDescription**  
필수 여부: 아니요  
Service Catalog의 제품 버전 설명입니다.

## 입력 아티팩트
<a name="action-reference-ServiceCatalog-input"></a>
+ **아티팩트 수:** `1`
+ **설명:** 작업에 대한 입력 아티팩트입니다.

## 출력 아티팩트
<a name="action-reference-ServiceCatalog-output"></a>
+ **아티팩트 수:** `0` 
+ **설명:** 이 작업 유형에는 출력 아티팩트가 적용되지 않습니다.

## 서비스 역할 권한: Service Catalog 작업
<a name="edit-role-servicecatalog"></a>

Service Catalog 지원의 경우 다음을 정책 설명에 추가합니다.

```
{
    "Effect": "Allow",
    "Action": [
        "servicecatalog:ListProvisioningArtifacts",
        "servicecatalog:CreateProvisioningArtifact",
        "servicecatalog:DescribeProvisioningArtifact",
        "servicecatalog:DeleteProvisioningArtifact",
        "servicecatalog:UpdateProduct"
    ],
    "Resource": "resource_ARN"
},
{
    "Effect": "Allow",
    "Action": [
        "cloudformation:ValidateTemplate"
    ],
    "Resource": "resource_ARN"
}
```

## 구성 파일 유형별 작업 구성 예제
<a name="action-reference-ServiceCatalog-example"></a>

다음 예는 별도의 구성 파일 없이 콘솔에 생성된 파이프라인에 대해 Service Catalog를 사용하는 배포 작업의 유효한 구성을 보여줍니다.

```
"configuration": {
  "TemplateFilePath": "S3_template.json",
  "ProductVersionName": "devops S3 v2",
  "ProductType": "CLOUD_FORMATION_TEMPLATE",
  "ProductVersionDescription": "Product version description",
  "ProductId": "prod-example123456"
}
```

다음 예는 별도의 `sample_config.json` 구성 파일로 콘솔에 생성된 파이프라인에 대해 Service Catalog를 사용하는 배포 작업의 유효한 구성을 보여줍니다.

```
"configuration": {
  "ConfigurationFilePath": "sample_config.json",
  "ProductId": "prod-example123456"
}
```

### 예제 작업 구성
<a name="action-reference-ServiceCatalog-example-default"></a>

------
#### [ YAML ]

```
Name: ActionName
ActionTypeId:
  Category: Deploy
  Owner: AWS
  Version: 1
  Provider: ServiceCatalog
OutputArtifacts:
- Name: myOutputArtifact
Configuration:
  TemplateFilePath: S3_template.json
  ProductVersionName: devops S3 v2
  ProductType: CLOUD_FORMATION_TEMPLATE
  ProductVersionDescription: Product version description
  ProductId: prod-example123456
```

------
#### [ JSON ]

```
{
    "Name": "ActionName",
    "ActionTypeId": {
        "Category": "Deploy",
        "Owner": "AWS",
        "Version": 1,
        "Provider": "ServiceCatalog"
    },
    "OutputArtifacts": [
        {
            "Name": "myOutputArtifact"
        }
    ],
    "Configuration": {
        "TemplateFilePath": "S3_template.json",
        "ProductVersionName": "devops S3 v2",
        "ProductType": "CLOUD_FORMATION_TEMPLATE",
        "ProductVersionDescription": "Product version description",
        "ProductId": "prod-example123456"
    }
}
```

------

## 다음 사항도 참조하세요.
<a name="action-reference-ServiceCatalog-links"></a>

이 작업을 수행할 때 참조할 수 있는 관련 리소스는 다음과 같습니다.
+ [Service Catalog 사용 설명서](https://docs.aws.amazon.com/servicecatalog/latest/userguide/) - Service Catalog의 리소스 및 템플릿에 대한 자세한 내용은 *Service Catalog 사용 설명서*를 참조하세요.
+ [자습서: Service Catalog에 배포하는 파이프라인 생성](tutorials-S3-servicecatalog.md) - 이 자습서에서는 Service Catalog에 제품 템플릿을 배포하고 소스 리포지토리에서 변경한 사항을 제공하기 위해 파이프라인을 생성하고 구성하는 방법을 보여 줍니다.