기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS IoT GreengrassDockerfile에서 컨테이너 이미지 빌드
AWS다운로드하여 Docker 컨테이너에서 Core 소프트웨어를 실행하는 데 사용할 수 있는 Dockerfile을 제공합니다. AWS IoT Greengrass Dockerfile에는 컨테이너 이미지를 빌드하기 위한 소스 코드가 포함되어 있습니다. AWS IoT Greengrass
AWS IoT Greengrass컨테이너 이미지를 빌드하기 전에 설치하려는 AWS IoT Greengrass Core 소프트웨어 버전을 선택하도록 Dockerfile을 구성해야 합니다. 또한 환경 변수를 구성하여 설치 중에 리소스를 프로비저닝하는 방법을 선택하고 다른 설치 옵션을 사용자 지정할 수 있습니다. 이 섹션에서는 Dockerfile에서 AWS IoT Greengrass Docker 이미지를 구성하고 빌드하는 방법을 설명합니다.
Dockerfile 패키지를 다운로드하십시오.
AWS IoT GreengrassDockerfile 패키지는 다음에서 다운로드할 수 있습니다. GitHub
패키지를 다운로드한 후 컴퓨터의 download-directory/aws-greengrass-docker-nucleus-version
AWS IoT GreengrassCore 소프트웨어 버전을 지정하십시오.
Dockerfile의 다음 빌드 인수를 사용하여 Docker 이미지에서 사용할 AWS IoT Greengrass Core 소프트웨어 버전을 지정합니다. AWS IoT Greengrass 기본적으로 Dockerfile은 최신 버전의 Core 소프트웨어를 사용합니다. AWS IoT Greengrass
GREENGRASS_RELEASE_VERSION-
Core 소프트웨어 버전. AWS IoT Greengrass 기본적으로 Dockerfile은 사용 가능한 최신 버전의 Greengrass 핵을 다운로드합니다. 값을 다운로드하려는 뉴클리어스 버전으로 설정합니다.
환경 변수 설정
환경 변수를 사용하면 Docker 컨테이너에 AWS IoT Greengrass Core 소프트웨어를 설치하는 방법을 사용자 지정할 수 있습니다. AWS IoT GreengrassDocker 이미지의 환경 변수를 다양한 방법으로 설정할 수 있습니다.
-
동일한 환경 변수를 사용하여 여러 이미지를 만들려면 Dockerfile에서 직접 환경 변수를 설정하십시오.
-
를
docker run사용하여 컨테이너를 시작하는 경우 명령에서 환경 변수를 인수로 전달하거나 환경 변수 파일에 환경 변수를 설정한 다음 파일을 인수로 전달하십시오. Docker에서 환경 변수를 설정하는 방법에 대한 자세한 내용은 Docker 설명서의 환경 변수를참조하십시오. -
를
docker-compose up사용하여 컨테이너를 시작하는 경우 환경 변수 파일에 환경 변수를 설정한 다음 파일을 인수로 전달하십시오. Compose에서 환경 변수를 설정하는 방법에 대한 자세한 내용은 Docker설명서를 참조하십시오.
AWS IoT GreengrassDocker 이미지에 대해 다음과 같은 환경 변수를 구성할 수 있습니다.
참고
Dockerfile에서 TINI_KILL_PROCESS_GROUP 변수를 수정하지 마세요. 이 변수를 사용하면 PID 그룹의 모든 PID에 SIGTERM 전달할 수 있으므로 Docker 컨테이너가 중지될 때 AWS IoT Greengrass Core 소프트웨어가 올바르게 종료될 수 있습니다.
GGC_ROOT_PATH-
(선택 사항) Core 소프트웨어의 루트로 사용할 컨테이너 내 폴더의 경로입니다. AWS IoT Greengrass
기본값:
/greengrass/v2 PROVISION-
(선택 사항) AWS IoT Greengrass Core에서 AWS 리소스를 프로비저닝할지 여부를 결정합니다.
-
지정하는
true경우 AWS IoT Greengrass Core 소프트웨어는 컨테이너 이미지를 사물로 등록하고 Greengrass 코어 장치에 AWS 필요한 리소스를 제공합니다. AWS IoT AWS IoT GreengrassCore 소프트웨어는 AWS IoT 사물 (선택 사항), AWS IoT 사물 그룹, IAM 역할 및 역할 별칭을 AWS IoT 프로비전합니다. 자세한 설명은 자동 리소스 프로비저닝으로 Docker AWS IoT Greengrass 컨테이너에서 실행 섹션을 참조하세요. -
지정하는
false경우 수동으로 생성한 AWS 리소스와 인증서를 사용하도록 지정하는 구성 파일을 생성하여 AWS IoT Greengrass Core 설치 프로그램에 제공해야 합니다. 자세한 설명은 수동 리소스 프로비저닝으로 Docker AWS IoT Greengrass 컨테이너에서 실행 섹션을 참조하세요.
기본값:
false -
AWS_REGION-
(선택 사항) AWS IoT Greengrass Core 소프트웨어가 필요한 AWS 리소스를 검색하거나 생성하는 데 사용하는 파일입니다. AWS 리전
기본값:
us-east-1. THING_NAME-
(선택 사항) 이 코어 디바이스로 AWS IoT 등록한 사물의 이름. 이 이름을 가진 사물이 사용자 AWS 계정 내부에 없는 경우 AWS IoT Greengrass Core 소프트웨어에서 해당 항목을 생성합니다.
이 인수를
PROVISION=true적용하도록 지정해야 합니다.기본값: 임의 UUID
GreengrassV2IotThing_추가. THING_GROUP_NAME-
(선택 사항) 이 코어 디바이스를 추가하는 AWS IoT 사물 그룹의 이름. 배포가 이 사물 그룹을 대상으로 하는 AWS IoT 경우 이 디바이스 및 해당 그룹의 다른 코어 디바이스가 연결될 때 해당 배포를 수신합니다. AWS IoT Greengrass 이 이름을 가진 사물 그룹이 사용자 AWS 계정 내에 없는 경우 AWS IoT Greengrass Core 소프트웨어에서 해당 사물 그룹을 생성합니다.
이 인수를
PROVISION=true적용하도록 지정해야 합니다. TES_ROLE_NAME-
(선택 사항) Greengrass 코어 디바이스가 서비스와 상호 작용할 AWS 수 있도록 하는 AWS 자격 증명을 획득하는 데 사용할 IAM 역할의 이름입니다. 이 이름을 가진 역할이 사용자 AWS 계정 내에 없는 경우 AWS IoT Greengrass Core 소프트웨어에서 정책을 사용하여 해당 역할을 생성합니다.
GreengrassV2TokenExchangeRoleAccess이 역할은 구성 요소 아티팩트를 호스팅하는 S3 버킷에 액세스할 수 없습니다. 따라서 구성 요소를 생성할 때 아티팩트의 S3 버킷 및 객체에 권한을 추가해야 합니다. 자세한 설명은 핵심 장치가 서비스와 상호 작용할 AWS 수 있도록 권한 부여 섹션을 참조하세요.기본값:
GreengrassV2TokenExchangeRole TES_ROLE_ALIAS_NAME-
(선택 사항) Greengrass 코어 디바이스의 AWS 자격 증명을 제공하는 IAM 역할을 가리키는 AWS IoT 역할 별칭의 이름. 이 이름의 역할 별칭이 사용자 AWS 계정 계정에 없는 경우 AWS IoT Greengrass Core 소프트웨어가 이를 생성하여 지정한 IAM 역할을 가리킵니다.
기본값:
GreengrassV2TokenExchangeRoleAlias COMPONENT_DEFAULT_USER-
(선택 사항) AWS IoT Greengrass Core 소프트웨어가 구성 요소를 실행하는 데 사용하는 시스템 사용자 및 그룹의 이름 또는 ID. 콜론으로 구분하여 사용자와 그룹을 지정합니다. 그룹은 선택 사항입니다. 예를 들어,
ggc_user:ggc_group또는ggc_user를 지정할 수 있습니다.-
루트로 실행하는 경우 구성 파일에 정의된 사용자 및 그룹이 기본값으로 설정됩니다. 구성 파일이 사용자 및 그룹을 정의하지 않는 경우 기본값은 입니다.
ggc_user:ggc_groupggc_user존재하거나 존재하지ggc_group않는 경우 소프트웨어에서 생성합니다. -
루트가 아닌 사용자로 실행하는 경우 AWS IoT Greengrass Core 소프트웨어는 해당 사용자를 사용하여 구성 요소를 실행합니다.
-
그룹을 지정하지 않으면 AWS IoT Greengrass Core 소프트웨어는 시스템 사용자의 기본 그룹을 사용합니다.
자세한 설명은 구성 요소를 실행하는 사용자를 구성하십시오. 섹션을 참조하세요.
-
DEPLOY_DEV_TOOLS-
컨테이너 이미지에 Greengrass CLI 구성 요소를 다운로드하고 배포할지 여부를 정의합니다. Greengrass CLI를 사용하여 로컬에서 구성 요소를 개발하고 디버그할 수 있습니다.
중요
이 구성 요소는 프로덕션 환경이 아닌 개발 환경에서만 사용하는 것이 좋습니다. 이 구성 요소를 사용하면 일반적으로 프로덕션 환경에서는 필요하지 않은 정보와 작업에 액세스할 수 있습니다. 이 구성 요소를 필요한 핵심 장치에만 배포하여 최소 권한 원칙을 따르세요.
기본값:
false INIT_CONFIG-
(선택 사항) AWS IoT Greengrass Core 소프트웨어를 설치하는 데 사용할 구성 파일의 경로입니다. 예를 들어 이 옵션을 사용하여 특정 핵 구성으로 새 Greengrass 코어 디바이스를 설정하거나 수동으로 프로비저닝된 리소스를 지정할 수 있습니다. 이 인수에 지정한 경로에 구성 파일을 마운트해야 합니다.
TRUSTED_PLUGIN-
이 기능은 Greengrass 핵 구성 요소 v2.4.0 이상에서 사용할 수 있습니다.
(선택 사항) 신뢰할 수 있는 플러그인으로 로드할 JAR 파일의 경로. 이 옵션을 사용하면 플릿 프로비저닝 또는 사용자 지정 프로비저닝으로 설치하는 등의 프로비저닝 플러그인 JAR 파일을 제공할 수 있습니다.
THING_POLICY_NAME-
이 기능은 Greengrass 핵 구성 요소 v2.4.0 이상에서 사용할 수 있습니다.
(선택 사항) 이 코어 디바이스의 사물 인증서에 첨부할 AWS IoT 정책의 이름. AWS IoT 이 이름을 가진 AWS IoT 정책이 사용자 내에 없는 경우 AWS IoT Greengrass 코어 소프트웨어에서 AWS 계정 해당 정책을 생성합니다.
이 인수를
PROVISION=true적용하도록 지정해야 합니다.참고
AWS IoT GreengrassCore 소프트웨어는 기본적으로 허용 AWS IoT 정책을 생성합니다. 이 정책의 범위를 좁히거나 사용 사례에 대한 권한을 제한하는 사용자 지정 정책을 만들 수 있습니다. 자세한 설명은 AWS IoT Greengrass V2코어 디바이스에 대한 최소 AWS IoT 정책 섹션을 참조하세요.
설치할 종속성을 지정합니다.
AWS IoT GreengrassDockerfile의 RUN 명령은 Core 소프트웨어 설치 프로그램을 실행하기 위한 컨테이너 환경을 준비합니다. AWS IoT Greengrass Docker 컨테이너에서 AWS IoT Greengrass Core 소프트웨어 설치 프로그램을 실행하기 전에 설치되는 종속성을 사용자 지정할 수 있습니다.
이미지 빌드 AWS IoT Greengrass
AWS IoT GreengrassDockerfile을 사용하여 컨테이너 이미지를 AWS IoT Greengrass 빌드합니다. Docker CLI 또는 Docker Compose CLI를 사용하여 이미지를 빌드하고 컨테이너를 시작할 수 있습니다. Docker CLI를 사용하여 이미지를 빌드한 다음 Docker Compose를 사용하여 해당 이미지에서 컨테이너를 시작할 수도 있습니다.
AWS IoT Greengrass컨테이너 이미지를 성공적으로 생성했습니다. Docker 이미지에는 AWS IoT Greengrass Core 소프트웨어가 설치되어 있습니다. 이제 Docker 컨테이너에서 AWS IoT Greengrass Core 소프트웨어를 실행할 수 있습니다.
