머신 러닝 구성 요소 사용자 지정

수정된 공개 추론 구성 요소를 배포하려면 (콘솔)

1. AWS IoT Greengrass 콘솔에 로그인합니다.

2. 탐색 메뉴에서 구성 요소를 선택합니다.

3. 구성 요소 페이지의 공용 구성 요소 탭에서 배포하려는 구성 요소를 선택합니다.

4. 구성 요소 페이지에서 배포를 선택합니다.

5. 배포에 추가에서 다음 중 하나를 선택합니다.

   1. 이 구성 요소를 대상 디바이스의 기존 배포에 병합하려면 기존 배포에 추가를 선택한 다음 수정하려는 배포를 선택합니다.

   2. 대상 디바이스에서 새 배포를 생성하려면 새 배포 생성을 선택합니다. 디바이스에 기존 배포가 있는 경우 이 단계를 선택하면 기존 배포가 대체됩니다.

6. 대상 지정 페이지에서 다음 작업을 수행합니다.

   1. 배포 정보 아래에서 친숙한 배포 이름을 입력하거나 수정합니다.

   2. 배포 대상 아래에서 배포 대상을 선택하고 다음을 선택합니다. 기존 배포 수정 시 배포 대상을 변경할 수 없습니다.

7. 구성 요소 선택 페이지의 공용 구성 요소에서 구성이 수정된 추론 구성 요소가 선택되었는지 확인하고 다음을 선택합니다.

8. 구성 요소 구성 페이지에서 다음을 수행하십시오.

   1. 추론 구성 요소를 선택하고 구성 요소 구성을 선택합니다.

   2. 구성 업데이트에서 업데이트하려는 구성 값을 입력합니다. 예를 들어 병합할 구성 상자에 다음 구성 업데이트를 입력하여 추론 간격을 15초로 변경하고 구성 요소가 custom.jpg 폴더에서 이름이 지정된 이미지를 찾도록 지시합니다. /custom-ml-inference/images/

      {
        "InferenceInterval": "15",
        "ImageName": "custom.jpg",
        "ImageDirectory": "/custom-ml-inference/images/"
      }

      구성 요소의 전체 구성을 기본값으로 재설정하려면 경로 재설정 상자에 빈 문자열 "" 하나를 지정하십시오.

   3. 확인을 선택하고 다음을 선택합니다.

9. 고급 설정 구성 페이지에서 기본 구성 설정을 유지하고 다음을 선택합니다.

10. 검토 페이지에서 [Deploy] 를 선택합니다.

1. 다음 명령을 실행하여 DLR 이미지 분류 구성 요소의 구성 요소 레시피를 검색합니다. 이 명령은 명령에서 제공하는 JSON 또는 YAML 레시피 파일에 구성 요소 레시피를 기록합니다.

   Linux, macOS, or Unix

   aws greengrassv2 get-component \
       --arn arn:aws:greengrass:region:aws:components:aws.greengrass.DLRImageClassification:versions:version \
       --recipe-output-format JSON | YAML \
       --query recipe \
       --output text | base64 --decode > <recipe-file>

   Windows Command Prompt (CMD)

   aws greengrassv2 get-component ^
       --arn arn:aws:greengrass:region:aws:components:aws.greengrass.DLRImageClassification:versions:version ^
       --recipe-output-format JSON | YAML ^
       --query recipe ^
       --output text > <recipe-file>.base64
   
   certutil -decode <recipe-file>.base64 <recipe-file>

   PowerShell

   aws greengrassv2 get-component `
       --arn arn:aws:greengrass:region:aws:components:aws.greengrass.DLRImageClassification:versions:version `
       --recipe-output-format JSON | YAML `
       --query recipe `
       --output text > <recipe-file>.base64
   
   certutil -decode <recipe-file>.base64 <recipe-file>

   <recipe-file>형식의 레시피 이름으로 바꾸십시오. <component-name>-<component-version>

2. 레시피의 ComponentDependencies 객체에서 사용하려는 모델 및 런타임 구성 요소에 따라 다음 중 하나 이상을 수행하십시오.

   • DLR로 컴파일된 모델을 사용하려면 DLR 구성 요소 종속성을 유지하세요. 다음 예제와 같이 사용자 지정 런타임 구성 요소에 대한 종속 항목으로 대체할 수도 있습니다.

     런타임 구성 요소

     JSON

     { 
         "<runtime-component>": {
             "VersionRequirement": "<version>",
             "DependencyType": "HARD"
         }
     }

     YAML

     <runtime-component>:
         VersionRequirement: "<version>"
         DependencyType: HARD

   • DLR 이미지 분류 모델 스토어 종속성을 유지하여 AWS 제공하는 사전 학습된 ResNet -50 모델을 사용하거나 사용자 지정 모델 구성 요소를 사용하도록 수정하십시오. 공개 모델 구성 요소에 대한 종속성을 포함하는 경우 구성 요소의 이후 사용자 지정 버전이 동일한 AWS 계정 버전에 존재하면 추론 구성 요소는 해당 사용자 지정 구성 요소를 사용합니다. AWS 리전 다음 예제와 같이 모델 구성 요소 종속성을 지정합니다.

     공개 모델 구성 요소

     JSON

     {
         "variant.DLR.ImageClassification.ModelStore": {
             "VersionRequirement": "<version>",
             "DependencyType": "HARD"
         }
     }

     YAML

     variant.DLR.ImageClassification.ModelStore:
         VersionRequirement: "<version>"
         DependencyType: HARD

     커스텀 모델 컴포넌트

     JSON

     {
         "<custom-model-component>": {
             "VersionRequirement": "<version>",
             "DependencyType": "HARD"
         }
     }

     YAML

     <custom-model-component>:
         VersionRequirement: "<version>"
         DependencyType: HARD

3. ComponentConfiguration개체에 이 구성 요소의 기본 구성을 추가합니다. 나중에 구성 요소를 배포할 때 이 구성을 수정할 수 있습니다. 다음 발췌문은 DLR 이미지 분류 구성 요소의 구성 요소 구성을 보여줍니다.

   예를 들어 사용자 지정 모델 구성 요소를 사용자 지정 추론 구성 요소의 종속 항목으로 사용하는 경우 사용 중인 모델의 이름을 ModelResourceKey 제공하도록 수정하십시오.

   JSON

   {
     "accessControl": {
       "aws.greengrass.ipc.mqttproxy": {
         "aws.greengrass.ImageClassification:mqttproxy:1": {
           "policyDescription": "Allows access to publish via topic ml/dlr/image-classification.",
           "operations": [
             "aws.greengrass#PublishToIoTCore"
           ],
           "resources": [
             "ml/dlr/image-classification"
           ]
         }
       }
     },
     "PublishResultsOnTopic": "ml/dlr/image-classification",
     "ImageName": "cat.jpeg",
     "InferenceInterval": 3600,
     "ModelResourceKey": {
       "armv7l": "DLR-resnet50-armv7l-cpu-ImageClassification",
       "x86_64": "DLR-resnet50-x86_64-cpu-ImageClassification",
       "aarch64": "DLR-resnet50-aarch64-cpu-ImageClassification"
     }
   }

   YAML

   accessControl:
       aws.greengrass.ipc.mqttproxy:
           'aws.greengrass.ImageClassification:mqttproxy:1':
               policyDescription: 'Allows access to publish via topic ml/dlr/image-classification.'
               operations:
                   - 'aws.greengrass#PublishToIoTCore'
               resources:
                   - ml/dlr/image-classification
   PublishResultsOnTopic: ml/dlr/image-classification
   ImageName: cat.jpeg
   InferenceInterval: 3600
   ModelResourceKey:
       armv7l: "DLR-resnet50-armv7l-cpu-ImageClassification"
       x86_64: "DLR-resnet50-x86_64-cpu-ImageClassification"
       aarch64: "DLR-resnet50-aarch64-cpu-ImageClassification"

4. Manifests개체에 구성 요소를 다른 플랫폼에 배포할 때 사용되는 이 구성 요소의 구성 및 아티팩트에 대한 정보와 구성 요소를 성공적으로 실행하는 데 필요한 기타 정보를 제공하십시오. 다음 발췌문은 DLR 이미지 분류 구성 요소의 Linux 플랫폼용 Manifests 개체 구성을 보여줍니다.

   JSON

   {
     "Manifests": [
       {
         "Platform": {
           "os": "linux",
           "architecture": "arm"
         },
         "Name": "32-bit armv7l - Linux (raspberry pi)",
         "Artifacts": [
           {
             "URI": "s3://SAMPLE-BUCKET/sample-artifacts-directory/image_classification.zip",
             "Unarchive": "ZIP"
           }
         ],
         "Lifecycle": {
           "Setenv": {
             "DLR_IC_MODEL_DIR": "{variant.DLR.ImageClassification.ModelStore:artifacts:decompressedPath}/{configuration:/ModelResourceKey/armv7l}",
             "DEFAULT_DLR_IC_IMAGE_DIR": "{artifacts:decompressedPath}/image_classification/sample_images/"
           },
           "run": {
             "RequiresPrivilege": true,
             "script": ". {variant.DLR:configuration:/MLRootPath}/greengrass_ml_dlr_venv/bin/activate\npython3 {artifacts:decompressedPath}/image_classification/inference.py"
           }
         }
       }
     ]
   }

   YAML

   Manifests:
     - Platform:
         os: linux
         architecture: arm
       Name: 32-bit armv7l - Linux (raspberry pi)
       Artifacts:
         - URI: s3://SAMPLE-BUCKET/sample-artifacts-directory/image_classification.zip
           Unarchive: ZIP
       Lifecycle:
         Setenv:
           DLR_IC_MODEL_DIR: "{variant.DLR.ImageClassification.ModelStore:artifacts:decompressedPath}/{configuration:/ModelResourceKey/armv7l}"
           DEFAULT_DLR_IC_IMAGE_DIR: "{artifacts:decompressedPath}/image_classification/sample_images/"
         run:
           RequiresPrivilege: true
           script: |-
             . {variant.DLR:configuration:/MLRootPath}/greengrass_ml_dlr_venv/bin/activate
             python3 {artifacts:decompressedPath}/image_classification/inference.py