지원 종료 공지: 2026년 10월 7일에는에 대한 지원을 중단할 AWS 예정입니다 AWS IoT Greengrass Version 1. 2026년 10월 7일 이후에는 더 이상 AWS IoT Greengrass V1 리소스에 액세스할 수 없습니다. 자세한 내용은 [에서 마이그레이션 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)을 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 배포 재설정
이 기능은 AWS IoT Greengrass 코어 v1.1 이상에서 사용할 수 있습니다.
다음 작업을 수행하여 그룹의 배포를 재설정할 수 있습니다.
+ 그룹의 코어를 다른 그룹으로 이동하려는 경우 또는 그룹의 코어가 다시 이미징된 경우 그룹을 삭제합니다. 그룹을 삭제하기 전에 다른 Greengrass 그룹과 함께 코어를 사용하도록 그룹 배포를 재설정해야 합니다.
+ 그룹의 코어를 다른 그룹으로 이동합니다.
+ 그룹의 상태를 배포 이전으로 되돌립니다.
+ 코어 장치에서 배포 구성을 제거합니다.
+ 코어 장치나 클라우드에서 중요한 데이터를 삭제합니다.
+ 현재 그룹에서 코어를 다른 코어로 바꾸지 않고 새 그룹 구성을 코어에 배치합니다.
**참고**
배포 재설정 기능은 AWS IoT Greengrass 코어 소프트웨어 v1.0.0에서는 제공되지 않습니다. v1.0.0을 이용해 배포된 그룹은 삭제할 수 없습니다.
재설정 배포 작업은 먼저 클라우드에 저장되어 있는 해당 그룹의 배포 정보를 모두 정리합니다. 그런 다음, 배포 관련 정보(Lambda 함수, 사용자 로그, 섀도우 데이터베이스 및 서버 인증서를 포함하지만 사용자가 정의한 `config.json` 또는 Greengrass 코어 인증서는 제외)도 모두 정리하도록 그룹의 코어 장치에 지시합니다. 그룹에 현재 `In Progress` 또는 `Building` 상태의 배포가 있는 경우 그룹에 대한 배포 재설정을 시작할 수 없습니다.
## AWS IoT 콘솔에서 배포 재설정
AWS IoT 콘솔의 그룹 구성 페이지에서 그룹 배포를 재설정할 수 있습니다.
1. AWS IoT 콘솔 탐색 창의 **관리**에서 **Greengrass 디바이스**를 확장한 다음 **그룹(V1)을** 선택합니다.
1. 대상 그룹을 선택합니다.
1. **배포** 탭에서 **배포 재설정**을 선택합니다.
1. **이 Greengrass Group의 배포 재설정** 대화 상자에 동의한다는 의미의 **confirm**을(를) 입력하고 **배포 재설정**을 선택합니다.
## AWS IoT Greengrass API를 사용하여 배포 재설정
, AWS CLI AWS IoT Greengrass API 또는 AWS SDK에서 `ResetDeployments` 작업을 사용하여 배포를 재설정할 수 있습니다. 이 단원의 예제에서는 CLI를 사용합니다.
```
aws greengrass reset-deployments --group-id {{GroupId}} [--force]
````reset-deployments` CLI 명령의 인수:
`--group-id`
그룹 ID입니다. `list-groups` 명령을 사용하여 이 값을 가져옵니다.
`--force`
선택 사항. 그룹의 코어 장치가 분실, 도난 또는 파괴된 경우 이 파라미터를 사용합니다. 이 옵션을 사용하면 배포 재설정 프로세스가 코어 장치의 응답을 기다리지 않고 클라우드에서 모든 배포 정보가 정리되고 난 후 성공을 보고합니다. 그러나 코어 장치가 활성 상태이거나 활성화되면 해당 정리 작업도 수행합니다.
`reset-deployments` CLI 명령의 출력은 다음과 같습니다.
```
{
"DeploymentId": "4db95ef8-9309-4774-95a4-eea580b6ceef",
"DeploymentArn": "arn:aws:greengrass:us-west-2:106511594199:/greengrass/groups/b744ed45-a7df-4227-860a-8d4492caa412/deployments/4db95ef8-9309-4774-95a4-eea580b6ceef"
}
```
다음과 같이 `get-deployment-status` CLI 명령을 사용하면 배포 재설정 상태를 확인할 수 있습니다.
```
aws greengrass get-deployment-status --deployment-id {{DeploymentId}} --group-id {{GroupId}}
````get-deployment-status` CLI 명령의 인수:
`--deployment-id`
배포 ID입니다.
`--group-id`
그룹 ID입니다.
`get-deployment-status` CLI 명령의 출력은 다음과 같습니다.
```
{
"DeploymentStatus": "Success",
"UpdatedAt": "2017-04-04T00:00:00.000Z"
}
```
배포 재설정을 준비 중일 때 `DeploymentStatus`는 `Building`으로 설정됩니다. 재설정 배포가 준비되었지만 AWS IoT Greengrass 코어가 재설정 배포를 선택하지 않은 경우는 `DeploymentStatus`입니다`InProgress`.
작업이 실패하면 응답에 오류 정보가 반환됩니다.
## 다음 사항도 참조하세요.
+ [AWS IoT Greengrass 코어에 AWS IoT Greengrass 그룹 배포](deployments.md)
+ *AWS IoT Greengrass Version 1 API 참조*의 [ResetDeployments](https://docs.aws.amazon.com/greengrass/v1/apireference/resetdeployments-post.html)
+ *AWS IoT Greengrass Version 1 API 참조*의 [GetDeploymentStatus](https://docs.aws.amazon.com/greengrass/v1/apireference/getdeploymentstatus-get.html)