Skip to content

Latest commit

 

History

History
364 lines (295 loc) · 10.8 KB

greengrass-commands.md

File metadata and controls

364 lines (295 loc) · 10.8 KB
Raw

Greengrass 명령어와 중요한 메모들

Greengrass 사용을 위한 IAM Role 및 Policy 설정

Greegrass를 처음 설치하는 경우에 아래와 같이 IAM Role과 Policy를 설정하여야 합니다. 이미 Greengrass를 사용중이라면 단계2로 이동합니다. Authorize core devices to interact with AWS services을 따라 IAM Console의 Policy에서 [Create policy]를 선택한 후에 JSON Tab에서 아래의 policy를 입력하여, “GreengrassV2TokenExchangeRoleAccess” 이름을 가지는 Policy를 생성합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:PutLogEvents",
        "logs:DescribeLogStreams",
        "s3:GetBucketLocation"
      ],
      "Resource": "*"
    }
  ]
}

마찬가지로 S3로 부터 artifact를 가져올 수 있도록 S3에 대한 접근권한을 가지는 “GGv2WorkshopS3Policy” Policy를 아래와 같이 생성합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject"
      ],
      "Resource": "arn:aws:s3:::*"
    }
  ]
}

IAM Console의 Roles에서 [Create role]을 선택하여 “GreengrassV2TokenExchangeRole” 이름을 가지는 Role을 생성합니다. 이때, “trusted entities”은 아래와 같이 설정합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "credentials.iot.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

이후, “GreengrassV2TokenExchangeRole”을 찾아서, [Add permissions]으로 “GGv2WorkshopS3Policy”과 “GreengrassV2TokenExchangeRoleAccess”을 추가합니다. 디바이스에서 Greengrass를 Provisioning하기 위하여, Minimal IAM policy for installer to provision resources에 따른 Policy를 account에 추가하여야 합니다. 여기서는 "aws-policy-greengrass" 이름의 Policy를 생성하려고 합니다. 먼저, Policy 생성에 필요한, account-id 정보를 AWS Console화면에서 확인하거나, 아래 명령어로 확인합니다.

aws sts get-caller-identity --query Account --output text

IAM Console의 Policies로 접속하여 [Create Policy]를 선택한 후 JSON 탭에서 아래와 같은 Policy를 생성합니다. 이때, 아래의 “account-id”에는 12자리 account번호를 입력합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "CreateTokenExchangeRole",
            "Effect": "Allow",
            "Action": [
                "iam:AttachRolePolicy",
                "iam:CreatePolicy",
                "iam:CreateRole",
                "iam:GetPolicy",
                "iam:GetRole",
                "iam:PassRole"
            ],
            "Resource": [
                "arn:aws:iam::account-id:role/GreengrassV2TokenExchangeRole",
                "arn:aws:iam::account-id:policy/GreengrassV2TokenExchangeRoleAccess"
            ]
        },
        {
            "Sid": "CreateIoTResources",
            "Effect": "Allow",
            "Action": [
                "iot:AddThingToThingGroup",
                "iot:AttachPolicy",
                "iot:AttachThingPrincipal",
                "iot:CreateKeysAndCertificate",
                "iot:CreatePolicy",
                "iot:CreateRoleAlias",
                "iot:CreateThing",
                "iot:CreateThingGroup",
                "iot:DescribeEndpoint",
                "iot:DescribeRoleAlias",
                "iot:DescribeThingGroup",
                "iot:GetPolicy"
            ],
            "Resource": "*"
        },
        {
            "Sid": "DeployDevTools",
            "Effect": "Allow",
            "Action": [
                "greengrass:CreateDeployment",
                "iot:CancelJob",
                "iot:CreateJob",
                "iot:DeleteThingShadow",
                "iot:DescribeJob",
                "iot:DescribeThing",
                "iot:DescribeThingGroup",
                "iot:GetThingShadow",
                "iot:UpdateJob",
                "iot:UpdateThingShadow"
            ],
            "Resource": "*"
        }
    ]
}

"aws-policy-greengrass" policy가 생성되면, IAM Console의 Users에서 현재 User에 "aws-policy-greengrass" policy를 [Add permissions]로 추가합니다.

Greengrass Preparation

  • Greengrass installer 다운로드

아래와 같이 Greengrass를 다운로드합니다.

curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip
unzip greengrass-nucleus-latest.zip -d GreengrassCore
  • Greengrass 설치

아래와 같이 Greengrass 디바이스를 IoT Core Device로 등록할 수 있습니다. 여기서 디바이스 이름은 "GreengrassCore-18163f7ac3e"으로 하였습니다. 여러개의 디바이스를 사용시에는 다른 이름을 사용하여야 합니다.

sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE -jar ./GreengrassCore/lib/Greengrass.jar \
	--aws-region ap-northeast-2 \
	--thing-name GreengrassCore-18163f7ac3e \
	--thing-group-name GreengrassGroup \
	--component-default-user ggc_user:ggc_group \
	--provision true \
	--setup-system-service true \
	--deploy-dev-tools true

Cloud9으로 개발환경을 구성시에는 Cloud9을 Greengrass 디바이스로 사용하기을 참조합니다.

Docker Container

Docker Container 준비에 따라 greengrass를 docker user group에 등록하고, ECR 퍼미션을 부여합니다.

Commands

  • Greengrass-cli 버전 확인
/greengrass/v2/bin/greengrass-cli -V
Greengrass CLI Version: 2.5.6
  • Component 리스트 확인하기
sudo /greengrass/v2/bin/greengrass-cli component list
  • 배포를 위한 Bucket에 파일 복사
MYBUCKET=greengrass-bucketname
aws s3 cp --recursive ~/GGv2Dev/ s3://$MYBUCKET
  • Local 배포전 Greengrass 서버에 component 등록
aws greengrassv2 create-component-version  \
--inline-recipe fileb://com.example.HelloMqtt-1.0.0.json \
--region $AWS_DEFAULT_REGION
  • S3를 이용한 배포전에 Greengrass에 component 등록
sudo /greengrass/v2/bin/greengrass-cli deployment create \
  --recipeDir ~/GGv2Dev/recipes \
  --artifactDir ~/GGv2Dev/artifacts \
  --merge "com.example.HelloMqtt=1.0.0"
  • Greengree 로그 확인
sudo tail -f /greengrass/v2/logs/greengrass.log
  • Component 로그 확인
sudo tail -f /greengrass/v2/logs/com.example.HelloMqtt.log
  • Component 재시작
sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld"
  • Component 삭제
sudo /greengrass/v2/bin/greengrass-cli deployment create --remove="com.example.HelloMqtt"
  • Greengrass 재시작
sudo systemctl restart greengrass.service

중요한 메모

  • Receipe 예제
{
    "RecipeFormatVersion": "2020-01-25",
    "ComponentName": "com.example.HelloMqtt",
    "ComponentVersion": "1.0.0",
    "ComponentDescription": "My first AWS IoT Greengrass component.",
    "ComponentPublisher": "Amazon",
    "ComponentConfiguration": {
        "DefaultConfiguration": {
            "accessControl": {
                "aws.greengrass.ipc.mqttproxy": {
                    "com.example.HelloMqtt:mqttproxy:1": {
                        "policyDescription": "Allows access to publish to all AWS IoT Core topics.",
	                    "operations": [
	                        "aws.greengrass#PublishToIoTCore"
	                    ],
	                    "resources": [
	                        "*"
	                    ]
	                }
                }
            }
        }
    },
    "Manifests": [{
        "Platform": {
            "os": "linux"
        },
        "Lifecycle": {
            "Install": {
                "RequiresPrivilege": true,
                "Script": "pip3 install awsiotsdk"
            },
            "Run": "python3 {artifacts:path}/hello_mqtt.py"
        },
        "Artifacts": [{
            "URI": "s3://greengrass-bucketname/artifacts/com.example.HelloMqtt/1.0.0/hello_mqtt.py"
        }]
    }]
}
{
    "RecipeFormatVersion": "2020-01-25",
    "ComponentName": "com.example.HelloMqtt",
    "ComponentVersion": "1.0.0",
    "ComponentDescription": "My first AWS IoT Greengrass component.",
    "ComponentPublisher": "Amazon",
    "ComponentConfiguration": {
        "DefaultConfiguration": {
	        "accessControl": {
                "aws.greengrass.ipc.mqttproxy": {
                    "com.example.HelloMqtt:mqttproxy:1": {
                        "policyDescription": "Allows access to publish to all AWS IoT Core topics.",
                        "operations": [
                            "aws.greengrass#PublishToIoTCore"
                        ],
                        "resources": [
                            "*"
                        ]
                    }
                }
            }
        }
    },
    "Manifests": [{
        "Platform": {
            "os": "linux"
        },
        "Lifecycle": {
            "Install": {
                "RequiresPrivilege": true,
                "Script": "sudo pip3 install awsiotsdk"
            },
            "Run": "python3 {artifacts:path}/hello_mqtt.py"
        }
    }]
}

Cloud9에서 EBS 크기 변경

Cloud9에서 EBS 크기 변경에 따라 cloud9의 볼륨을 조정할 수 있습니다.

Basic Docker Commends

  • Docker 소스로 이미지를 빌드합니다.
docker build -t example:v1 .
  • 빌드된 이미지를 확인합니다.
docker images
  • Docker를 실행합니다.
docker run -d -p 8080:8080 example:v1
  • Docker의 실행된 container 정보를 확인합니다.
docker ps

CONTAINER ID   IMAGE          COMMAND                  CREATED         STATUS         PORTS                    NAMES
41e297948511   example:v1   "/lambda-entrypoint.…"   6 seconds ago   Up 4 seconds   0.0.0.0:8080->8080/tcp   stupefied_carson
  • Bash shell로 접속합니다.
docker exec -it  41e297948511 /bin/bash