AWS IoT Greengrass 스트림 관리자 구성

1. AWS IoT 콘솔 탐색 창의 관리에서 Greengrass 디바이스를 확장한 다음 그룹(V1)을 선택합니다.

2. 대상 그룹을 선택합니다.

3. Lambda 함수 탭을 선택합니다.

4. 시스템 Lambda 함수에서 스트림 관리자를 선택하고 편집을 선택합니다.

5. 활성화 또는 비활성화 상태를 확인합니다. 구성된 모든 사용자 지정 스트림 관리자 설정도 표시됩니다.

1. AWS IoT 콘솔 탐색 창의 관리에서 Greengrass 디바이스를 확장한 다음 그룹(V1)을 선택합니다.

2. 그룹 생성을 선택합니다. 다음 페이지에서 선택한 항목에 따라 그룹에 대한 스트림 관리자를 구성하는 방법이 결정됩니다.

3. 그룹 이름 지정을 진행하고 Greengrass 코어 페이지를 선택합니다.

4. 그룹 생성을 선택합니다.

5. 그룹 구성 페이지에서 Lambda 함수 탭을 선택하고 스트림 관리자를 선택한 다음 편집을 선택합니다.

   • 스트림 관리자를 기본 설정으로 활성화하려면 기본 설정으로 활성화를 선택합니다.

      

   • 사용자 지정 설정으로 스트림 관리자를 활성화하려면 설정 사용자 지정을 선택합니다.

     1. 스트림 관리자 구성 페이지에서 사용자 지정 설정으로 활성화를 선택합니다.

     2. 사용자 정의 설정에 스트림 관리자 파라미터의 값을 입력합니다. 자세한 내용은 스트림 관리자 파라미터 섹션을 참조하세요. AWS IoT Greengrass이 기본값을 사용할 수 있도록 필드를 비워 둡니다.

         

   • 스트림 관리자를 비활성화하려면 비활성화를 선택합니다.

     1. Configure stream manager(스트림 관리자 구성) 페이지에서 비활성화를 선택합니다.

         

6. Save를 선택합니다.

7. 나머지 페이지를 계속 진행하여 그룹을 생성합니다.

8. 클라이언트 디바이스 페이지에서 보안 리소스를 다운로드하고 정보를 검토한 다음, 완료를 선택합니다.

   참고

   스트림 관리자가 활성화된 경우 그룹을 배포하기 전에 코어 디바이스에 Java 8 런타임을 설치해야 합니다.

1. AWS IoT 콘솔 탐색 창의 관리에서 Greengrass 디바이스를 확장한 다음 그룹(V1)을 선택합니다.

2. 대상 그룹을 선택합니다.

3. Lambda 함수 탭을 선택합니다.

4. 시스템 Lambda 함수에서 스트림 관리자를 선택하고 편집을 선택합니다.

5. 활성화 또는 비활성화 상태를 확인합니다. 구성된 모든 사용자 지정 스트림 관리자 설정도 표시됩니다.

1. AWS IoT 콘솔 탐색 창의 관리에서 Greengrass 디바이스를 확장한 다음 그룹(V1)을 선택합니다.

2. 대상 그룹을 선택합니다.

3. Lambda 함수 탭을 선택합니다.

4. 시스템 Lambda 함수에서 스트림 관리자를 선택하고 편집을 선택합니다.

5. 활성화 또는 비활성화 상태를 확인합니다. 구성된 모든 사용자 지정 스트림 관리자 설정도 표시됩니다.

6. Save를 선택합니다.

1. 대상 Greengrass 그룹 및 그룹 버전의 ID를 확인합니다. 이 절차에서는 이것이 최신 그룹 및 그룹 버전이라고 가정합니다. 다음 쿼리는 가장 최근에 생성된 그룹을 반환합니다.

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   또는 이름으로 쿼리할 수도 있습니다. 그룹 이름은 고유한 이름이 아니어도 되므로 여러 그룹을 반환할 수도 있습니다.

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   참고

   AWS IoT 콘솔에서도 이러한 값을 찾을 수 있습니다. 그룹 ID는 그룹의 설정 페이지에 표시됩니다. 그룹 버전 ID는 그룹의 배포 탭에 표시됩니다.

2. 출력에서 대상 그룹의 Id 및 LatestVersion 값을 복사합니다.

3. 최신 그룹 버전을 확인합니다.

   • group-id를 복사한 Id로 바꿉니다.

   • latest-group-version-id를 복사한 LatestVersion으로 바꿉니다.

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id

4. 출력의 FunctionDefinitionVersionArn에서 함수 정의 및 함수 정의 버전의 ID를 복사합니다.

   • 함수 정의 ID는 Amazon 리소스 이름(ARN)의 functions 세그먼트 뒤에 나오는 GUID입니다.

   • 함수 정의 버전 ID는 ARN의 versions 세그먼트 뒤에 나오는 GUID입니다.

   arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/function-definition-id/versions/function-definition-version-id

5. 함수 정의 버전을 가져옵니다.

   • function-definition-id를 함수 정의 ID로 바꿉니다.

   • function-definition-version-id를 함수 정의 버전 ID로 바꿉니다.

   aws greengrass get-function-definition-version \
   --function-definition-id function-definition-id \
   --function-definition-version-id function-definition-version-id

스트림 관리자를 활성화, 비활성화 또는 구성하려면(CLI)

1. 대상 Greengrass 그룹 및 그룹 버전의 ID를 확인합니다. 이 절차에서는 이것이 최신 그룹 및 그룹 버전이라고 가정합니다. 다음 쿼리는 가장 최근에 생성된 그룹을 반환합니다.

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   또는 이름으로 쿼리할 수도 있습니다. 그룹 이름은 고유한 이름이 아니어도 되므로 여러 그룹을 반환할 수도 있습니다.

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   참고

   AWS IoT 콘솔에서도 이러한 값을 찾을 수 있습니다. 그룹 ID는 그룹의 설정 페이지에 표시됩니다. 그룹 버전 ID는 그룹의 배포 탭에 표시됩니다.

2. 출력에서 대상 그룹의 Id 및 LatestVersion 값을 복사합니다.

3. 최신 그룹 버전을 확인합니다.

   • group-id를 복사한 Id로 바꿉니다.

   • latest-group-version-id를 복사한 LatestVersion으로 바꿉니다.

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id

4. FunctionDefinitionVersionArn을 제외한 CoreDefinitionVersionArn 및 모든 버전 ARN을 출력에서 복사합니다. 나중에 새 그룹 버전을 만들 때 이러한 값들이 사용됩니다.

5. 출력의 FunctionDefinitionVersionArn에서 함수 정의의 ID를 복사합니다. 다음 예제에서와 같이, ARN에서 functions 세그먼트 다음에 나오는 GUID가 ID가 됩니다.

   arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/bcfc6b49-beb0-4396-b703-6dEXAMPLEcu5/versions/0f7337b4-922b-45c5-856f-1aEXAMPLEsf6

   참고

   또는 create-function-definition 명령을 실행하여 함수 정의를 생성하고, 출력에서 ID를 복사할 수 있습니다.

6. 함수 정의에 함수 정의 버전을 추가합니다.

   • function-definition-id를 함수 정의에서 복사한 Id로 바꿉니다.

   • functions 배열에 Greengrass 코어에 사용할 수 있게 하려는 다른 모든 함수를 포함시킵니다. get-function-definition-version 명령을 사용하여 기존 함수 목록을 가져올 수 있습니다.

    

   기본 설정으로 스트림 관리자 활성화

   다음 예제에서는 functions 배열에 GGStreamManager 함수를 포함하여 스트림 관리자를 활성화합니다. 이 예제에서는 스트림 관리자 파라미터에 기본값을 사용합니다.

   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[
           {
               "FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
               "FunctionConfiguration": {
                   "MemorySize":  4194304,
                   "Pinned": true,
                   "Timeout": 3
               },
               "Id": "streamManager"
           },
           {    
               "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyLambdaFunction:MyAlias",
               "FunctionConfiguration": {
                   "Executable": "myLambdaFunction.function_handler",
                   "MemorySize": 16000,
                   "Pinned": true,
                   "Timeout": 5
               },
               "Id": "myLambdaFunction"
           },
           ... more user-defined functions
       ]
   }'

   참고

   이 예제의 myLambdaFunction 함수는 사용자 정의 Lambda 함수 중 하나를 나타냅니다.

   사용자 지정 설정으로 스트림 관리자 활성화

   다음 예제에서는 functions 배열에 GGStreamManager 함수를 포함하여 스트림 관리자를 활성화합니다. 기본값을 변경하지 않는 한 모든 스트림 관리자 설정은 선택 사항입니다. 이 예제에서는 환경 변수를 사용하여 사용자 지정 값을 설정하는 방법을 보여줍니다.

   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[
           {
               "FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
               "FunctionConfiguration": {
                   "Environment": {
                       "Variables": {
                           "STREAM_MANAGER_STORE_ROOT_DIR": "/data",
                           "STREAM_MANAGER_SERVER_PORT": "1234",
                           "STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE": "4"
                       }
                   },
                   "MemorySize":  4194304,
                   "Pinned": true,
                   "Timeout": 3
               },
               "Id": "streamManager"
           },
           {    
               "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyLambdaFunction:MyAlias",
               "FunctionConfiguration": {
                   "Executable": "myLambdaFunction.function_handler",
                   "MemorySize": 16000,
                   "Pinned": true,
                   "Timeout": 5
               },
               "Id": "myLambdaFunction"
           },
           ... more user-defined functions
       ]
   }'

   참고

   FunctionConfiguration 속성의 경우 다음 사항을 알고 있을 수 있습니다.

   • MemorySize는 기본 설정으로 4194304KB(4GB)로 설정됩니다. 이 값은 언제든지 변경할 수 있습니다. 최소 128,000KB로 MemorySize를 설정하는 것이 좋습니다.

   • Pinned를 true로 설정해야 합니다.

   • Timeout은 함수 정의 버전에서 필요하지만, GGStreamManager에서는 이를 사용하지 않습니다.

   스트림 관리자 비활성화

   다음 예제에서는 GGStreamManager 함수를 생략하여 스트림 관리자를 비활성화합니다.

   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[
           {       
               "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyLambdaFunction:MyAlias",
               "FunctionConfiguration": {
                   "Executable": "myLambdaFunction.function_handler",
                   "MemorySize": 16000,
                   "Pinned": true,
                   "Timeout": 5
               },
               "Id": "myLambdaFunction"
           },
           ... more user-defined functions
       ]
   }'

   참고

   Lambda 함수를 배포하지 않으려면 함수 정의 버전을 완전히 생략할 수 있습니다.

7. 출력에서 함수 정의 버전의 Arn를 복사합니다.

8. 시스템 Lambda 함수를 포함하는 그룹 버전을 만듭니다.

   • group-id를 그룹의 Id로 바꿉니다.

   • core-definition-version-arn을 최신 그룹 버전에서 복사한 CoreDefinitionVersionArn으로 바꿉니다.

   • function-definition-version-arn을 새 함수 정의 버전에서 복사한 Arn으로 바꿉니다.

   • 최신 그룹 버전에서 복사한 다른 그룹 구성 요소의 ARN(예: SubscriptionDefinitionVersionArn 또는 DeviceDefinitionVersionArn)을 바꿉니다.

   • 사용되지 않은 파라미터를 모두 제거합니다. 예를 들어 그룹 버전에 리소스가 포함되어 있지 않으면 --resource-definition-version-arn을 제거합니다.

   aws greengrass create-group-version \
   --group-id group-id \
   --core-definition-version-arn core-definition-version-arn \
   --function-definition-version-arn function-definition-version-arn \
   --device-definition-version-arn device-definition-version-arn \
   --logger-definition-version-arn logger-definition-version-arn \
   --resource-definition-version-arn resource-definition-version-arn \
   --subscription-definition-version-arn subscription-definition-version-arn

9. 출력에서 Version을 복사합니다. 새 그룹 버전의 ID가 이 값이 됩니다.

10. 새로운 그룹 버전을 사용하여 그룹을 배포합니다.

    • group-id를 해당 그룹에서 복사한 Id로 바꿉니다.

    • group-version-id를 새 그룹 버전에서 복사한 Version으로 바꿉니다.

    aws greengrass create-deployment \
    --group-id group-id \
    --group-version-id group-version-id \
    --deployment-type NewDeployment