기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 소프트웨어 패키지 카탈로그 시작
, AWS Management Console AWS IoT Core API 작업 및 AWS Command Line Interface ()를 통해 AWS IoT Device Management 소프트웨어 패키지 카탈로그를 빌드하고 유지 관리할 수 있습니다AWS CLI.
**참고**
AWS IoT 플릿 인덱싱을 활성화하려면 소프트웨어 패키지 카탈로그를 사용해야 합니다. 에서 소프트웨어 패키지 버전을 생성하고 `CreatePackage` API 명령을 AWS Management Console 사용하는 등의 기본 작업은 AWS IoT 플릿 인덱싱을 활성화하지 않으면 실패합니다.
소프트웨어 패키지 카탈로그에서 AWS IoT 플릿 인덱싱을 사용하는 방법에 대한 자세한 내용은 섹션을 참조하세요[플릿 인덱싱 준비](preparing-fleet-indexing.md).
**콘솔 사용**
를 사용하려면 AWS 계정에 AWS Management Console로그인하고 로 이동합니다[AWS IoT Core](https://console.aws.amazon.com/iot/home). 탐색 창에서 **소프트웨어 패키지**를 선택합니다. 그런 다음 이 섹션에서 패키지와 해당 버전을 만들고 관리할 수 있습니다.
**API 또는 CLI 작업 사용**
AWS IoT Core API 작업을 사용하여 소프트웨어 패키지 카탈로그 기능을 생성하고 관리할 수 있습니다. 자세한 내용은 [AWS IoT API 참조](https://docs.aws.amazon.com/iot/latest/apireference/)와AWS [ SDK 및 도구](https://aws.amazon.com/developer/tools/)를 참조하세요. AWS CLI 명령은 카탈로그도 관리합니다. 자세한 내용은 [AWS IoT CLI 명령 참조](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/index.html)를 참조하세요.
**Topics**
+ [소프트웨어 패키지 및 패키지 버전 생성](creating-package-and-version.md)
+ [AWS IoT 작업을 통해 패키지 버전 배포](deploying-package-version.md)
+ [패키지 버전을 AWS IoT 사물에 연결](associating-package-version.md)
# 소프트웨어 패키지 및 패키지 버전 생성
다음 단계에 따라 AWS Management Console을 통해 패키지와 초기 버전을 만들 수 있습니다.
**소프트웨어 패키지를 만드는 방법**
1. AWS 계정에 로그인하고 [AWS IoT 콘솔](https://console.aws.amazon.com/iot/home)로 이동합니다.
1. 탐색 창에서 **소프트웨어 패키지**를 선택합니다.
1. **AWS IoT 소프트웨어 패키지** 페이지에서 **패키지 생성**을 선택합니다. **패키지 관리를 위한 종속성 활성화** 대화 상자가 나타납니다.
1. **플릿 인덱싱**에서 **디바이스 소프트웨어 패키지 및 버전 추가**를 선택합니다. 이는 소프트웨어 패키지 카탈로그에 필요하며 플릿에 대한 플릿 인덱싱 및 지표를 제공합니다.
1. [선택 사항] AWS IoT 작업이 성공적으로 완료되면 예약된 명명된 섀도우를 업데이트하도록 하려면 **작업에서 섀도우 자동 업데이트를** 선택합니다. AWS IoT 작업이이 업데이트를 수행하지 않도록 하려면이 확인란을 선택하지 않은 상태로 둡니다.
1. [선택 사항] 예약된 명명된 섀도우를 업데이트할 수 있는 권한을 AWS IoT 작업에 부여하려면 **역할 선택**에서 **역할 생성을** 선택합니다. AWS IoT 작업이이 업데이트를 수행하지 않도록 하려면이 역할이 필요하지 않습니다.
1. 역할을 생성하거나 선택합니다.
1. 이 목적을 위한 **역할이 없는** 경우: **역할 생성**생성 대화 상자가 나타나면 **역할 이름**을 입력한 다음 **생성**을 선택합니다.
1. 이 목적을 위한 **역할이 있는** 경우: **역할 선택**에서 역할을 선택한 다음 **IAM 역할에 정책 연결** 확인란이 선택되어 있는지 확인합니다.
1. **확인**을 선택합니다. **새 패키지 생성** 페이지가 나타납니다.
1. **패키지 세부 정보**에서 **패키지 이름**을 입력합니다.
1. **패키지 설명**에서 이 패키지를 식별하고 관리하는 데 도움이 되는 정보를 입력합니다.
1. [선택 사항] 태그를 사용하여 이 패키지를 분류하고 관리할 수 있습니다. 태그를 추가하려면 **태그**를 확장하고 태그 **추가**를 선택한 다음 키-값 페어를 입력합니다. 최대 50개의 태그를 추가할 수 있습니다. 자세한 내용은 [AWS IoT 리소스 태그 지정을 참조하세요](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html).
**새 패키지를 만들 때 패키지 버전을 추가하는 방법**
1. **첫 번째 버전**에서 **버전 이름**을 입력합니다.
패키지 버전을 고유하게 식별하려면 [SemVer 형식](https://semver.org/)(예:`1.0.0.0`)을 사용하는 것이 좋습니다. 사용 사례에 더 적합한 다른 형식 지정 전략을 사용할 수도 있습니다. 자세한 내용은 [패키지 버전 수명 주기](preparing-to-use-software-package-catalog.md#package-version-lifecycle) 단원을 참조하십시오.
1. **버전 설명**에서 이 패키지 버전을 식별하고 관리하는 데 도움이 되는 정보를 입력합니다.
**참고**
패키지 버전이 `draft` 상태에서 생성되므로 **기본 버전** 확인란은 비활성화되어 있습니다. 패키지 버전을 만든 후 상태를 `published`로 변경할 때 기본 버전의 이름을 지정할 수 있습니다. 자세한 내용은 [패키지 버전 수명 주기](preparing-to-use-software-package-catalog.md#package-version-lifecycle) 단원을 참조하십시오.
1. [선택 사항] 이 버전을 관리하거나 디바이스에 정보를 전달하는 데 도움이 되도록 **버전 속성**에 하나 이상의 이름-값 페어를 입력하세요. 입력한 각 이름-값 페어에 대해 **속성 추가**를 선택합니다. 자세한 내용은 [버전 속성](preparing-to-use-software-package-catalog.md#version-attributes) 단원을 참조하십시오.
1. [선택 사항] 태그를 사용하여 이 패키지를 분류하고 관리할 수 있습니다. 태그를 추가하려면 **태그**를 확장하고 태그 **추가**를 선택한 다음 키-값 페어를 입력합니다. 최대 50개의 태그를 추가할 수 있습니다. 자세한 내용은 [AWS IoT 리소스 태그 지정을 참조하세요](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html).
1. **다음**을 선택합니다.
**소프트웨어 재료표를 패키지 버전에 연결(선택 사항)**
1. **SBOMs 구성** 창의 **3단계: 버전 SBOM(선택 사항)**에서 패키지 버전에 연결하기 전에 소프트웨어 재료표를 검증하는 데 사용되는 기본 SBOM 파일 형식 및 검증 모드를 선택합니다.
1. **SBOM 파일 추가** 창에서 버전이 지정된 Amazon S3 버킷을 나타내는 Amazon 리소스 이름(ARN)과 기본 유형이 작동하지 않는 경우 선호하는 SBOM 파일 형식을 입력합니다.
**참고**
패키지 버전에 대한 소프트웨어 자재 명세서가 두 개 이상인 경우 단일 SBOM 파일 또는 여러 SBOM이 포함된 단일 zip 파일을 추가할 수 있습니다.
1. **추가된 SBOM 파일** 창에서 패키지 버전에 추가한 SBOM 파일을 볼 수 있습니다.
1. **패키지 및 버전 생성**을 선택합니다. 패키지 버전 페이지가 나타나고 **추가된 SBOM 파일** 창에서 SBOM 파일의 검증 상태를 볼 수 있습니다. SBOM 파일이 검증을 거치면 초기 상태가 `In progress`가 됩니다.
**참고**
SBOM 파일 검증 상태는 `Invalid file`, `Not started`, `In progress`, `Validated (SPDX)`, `Validated (CycloneDX)` 및 검증 실패 이유입니다.
# AWS IoT 작업을 통해 패키지 버전 배포
다음 단계에 따라 AWS Management Console을 통해 패키지 버전을 배포할 수 있습니다.
**사전 조건**:
시작하기 전에 다음을 수행하십시오.
+ 에 AWS IoT 사물을 등록합니다 AWS IoT Core. 디바이스를 추가하는 방법에 대한 지침은 [사물 객체 생성을](https://docs.aws.amazon.com/iot/latest/developerguide/create-iot-resources.html#create-aws-thing) AWS IoT Core참조하세요.
+ [선택 사항] AWS IoT 패키지 버전을 배포할 디바이스를 대상으로 하는 사물 그룹 또는 동적 사물 그룹을 생성합니다. 사물 그룹을 생성하는 방법에 대한 지침은 [정적 사물 그룹 생성](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html#create-thing-group)을 참조하세요. 동적 사물 그룹을 생성하는 방법에 대한 지침은 [동적 사물 그룹 생성](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html#create-dynamic-thing-group)을 참조하세요.
+ 소프트웨어 패키지 및 패키지 버전 생성 자세한 내용은 [소프트웨어 패키지 및 패키지 버전 생성](creating-package-and-version.md) 단원을 참조하십시오.
+ 작업 문서를 만듭니다. 자세한 내용은 [배포를 위한 작업 문서 및 패키지 버전 준비](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#preparing-to-deploy)를 참조하세요.
**AWS IoT 작업을 배포하려면**
1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/home)에서 **소프트웨어 패키지**를 선택합니다.
1. 배포하려는 소프트웨어 패키지를 선택합니다. **소프트웨어 패키지 세부 정보** 페이지가 나타납니다.
1. **버전**에서 배포하려는 패키지 버전을 선택하고 **작업 버전 배포**를 선택합니다.
1. 이 포털을 통해 작업을 배포하는 것이 처음인 경우 요구 사항을 설명하는 대화 상자가 나타납니다. 정보를 검토하고 **확인**을 선택합니다.
1. 배포 이름을 입력하거나 **이름** 필드에 자동 생성된 이름을 그대로 둡니다.
1. [선택 사항] **설명** 필드에 배포의 목적이나 내용을 식별하는 설명을 입력하거나 자동 생성된 정보를 그대로 둡니다.
**참고:** 작업 이름 및 설명 필드에 개인 식별 정보를 사용하지 않는 것이 좋습니다.
1. [선택 사항] 이 작업과 연결할 태그를 추가합니다.
1. **다음**을 선택합니다.
1. **작업 대상**에서 작업을 받아야 하는 사물 또는 사물 그룹을 선택합니다.
1. **작업 파일** 필드에 작업 문서 JSON 파일을 지정합니다.
1. **패키지 카탈로그 서비스와 작업 통합**을 엽니다.
1. 작업 문서에 지정된 패키지 및 버전을 선택합니다.
**참고**
작업 문서에 지정된 것과 동일한 패키지 및 패키지 버전을 선택해야 합니다. 더 많이 포함할 수 있지만 작업은 작업 문서에 포함된 패키지 및 버전에 대한 지침만 발행합니다. 자세한 내용은 [배포 시 패키지 및 버전 이름 지정](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#naming-package-versions)을 참조하세요.
1. **다음**을 선택합니다.
1. 작업 구성 페이지의 작업 구성 대화 상자에서 다음 작업 유형 중 하나를 선택합니다.
+ **스냅샷 작업:** 스냅샷 작업은 대상 디바이스 및 그룹에서 실행이 완료되면 완료됩니다.
+ **연속 작업:** 연속 작업은 사물 그룹에 적용되며 이후에 지정된 대상 그룹에 추가하는 모든 디바이스에서 실행됩니다.
1. **추가 구성 - 선택 사항** 대화 상자에서 다음과 같은 선택적 작업 구성을 검토하고 적절히 선택합니다. 자세한 내용은 [작업 롤아웃, 예약 및 중단 구성](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-rollout-abort-scheduling)과 [작업 실행 제한 시간 및 재시도 구성](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-timeout-retry)을 참조하세요.
+ Rollout configuration(롤아웃 구성)
+ Scheduling configuration(예약 구성)
+ Job executions timeout configuration(작업 실행 제한 시간 구성)
+ 작업 실행 재시도 구성
+ Abort configuration(중단 구성)
1. 작업 선택을 검토한 다음 **제출**을 선택합니다.
작업을 생성하면 콘솔에서는 JSON 서명을 생성해 작업 문서에 배치합니다. AWS IoT 콘솔을 사용하여 작업 상태를 보거나 작업을 취소 또는 삭제할 수 있습니다. 작업을 관리하려면 [콘솔의 작업 허브(Job hub of the console)](https://console.aws.amazon.com/iot/home#/jobhub)로 이동합니다.
# 패키지 버전을 AWS IoT 사물에 연결
디바이스에 소프트웨어를 설치한 후 패키지 버전을 예약된 명명된 AWS IoT 사물 섀도에 연결할 수 있습니다. AWS IoT 작업이 배포되고 성공적으로 완료된 후 사물의 예약된 명명된 섀도우를 업데이트하도록 작업이 구성된 경우이 절차를 완료할 필요가 없습니다. 자세한 내용은 [명명된 예약 섀도우](preparing-to-use-software-package-catalog.md#reserved-named-shadow) 단원을 참조하십시오.
**사전 조건**:
시작하기 전에 다음을 수행하십시오.
+ AWS IoT 사물 또는 사물을 생성하고를 통해 원격 측정을 설정합니다 AWS IoT Core. 자세한 내용은 [시작하기를 참조하세요 AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/iot-gs.html).
+ 소프트웨어 패키지 및 패키지 버전을 생성합니다. 자세한 내용은 [소프트웨어 패키지 및 패키지 버전 생성](creating-package-and-version.md) 단원을 참조하십시오.
+ 디바이스에 패키지 버전 소프트웨어를 설치합니다.
**참고**
패키지 버전을 AWS IoT 사물에 연결해도 물리적 디바이스에 소프트웨어가 업데이트되거나 설치되지 않습니다. 패키지 버전을 디바이스에 배포해야 합니다.
**패키지 버전을 AWS IoT 사물에 연결하려면**
1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/home) 탐색 창에서 **모든 디바이스** 메뉴를 펼치고 **사물**을 선택합니다.
1. 목록에서 업데이트하려는 AWS IoT 사물을 식별하고 사물 이름을 선택하여 세부 정보 페이지를 표시합니다.
1. **세부 정보** 섹션에서 **패키지 및 버전**을 선택합니다.
1. **패키지 및 버전에 추가**를 선택합니다.
1. **디바이스 패키지 선택**에서 원하는 소프트웨어 패키지를 선택합니다.
1. **버전 선택**에서 원하는 소프트웨어 버전을 선택합니다.
1. **디바이스 패키지 추가**를 선택합니다.
패키지와 버전이 **선택한 패키지 및 버전** 목록에 표시됩니다.
1. 이 사물에 연결할 각 패키지 및 버전에 대해 이 단계를 반복합니다.
1. 완료하면 **패키지 및 버전 세부 정보 추가**를 선택합니다. **사물 세부 정보** 페이지가 열리고 목록에서 새 패키지와 버전을 볼 수 있습니다.