Sagemaker AI 예약 노트북 작업에서 발생하는 문제를 해결하려면 어떻게 해야 합니까?

해결 방법

노트북 작업이 예약된 시간 동안 실행되지 않음

예약된 노트북 작업은 Amazon EventBridge 및 SageMaker AI 교육 및 파이프라인 서비스를 사용합니다. 노트북이 예약된 시간 동안 실행되지 않으면 AWS Identity and Access Management(IAM) 역할에 필요한 권한이 없을 수 있습니다.

노트북 작업을 생성하고 예약하는 데 사용한 IAM 역할은 SageMaker AI Studio 도메인 역할이거나 도메인의 개별 사용자 프로필에 연결된 역할입니다.

예약된 노트북 작업에 대한 Amazon CloudWatch 이벤트를 관리할 권한을 부여하려면 예약된 노트북 작업에 다음 정책을 추가하십시오.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "events:TagResource",
                "events:DeleteRule",
                "events:PutTargets",
                "events:DescribeRule",
                "events:PutRule",
                "events:RemoveTargets",
                "events:DisableRule",
                "events:EnableRule"
            ],
            "Resource": "*",
            "Condition": {
              "StringEquals": {
                "aws:ResourceTag/sagemaker:is-scheduling-notebook-job": "true"
              }
            }
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": "iam:PassRole",
            "Resource": "arn:aws:iam::*:role/*",
            "Condition": {
                "StringLike": {
                    "iam:PassedToService": "events.amazonaws.com"
                }
            }
        },
        {
            "Sid": "VisualEditor2",
            "Effect": "Allow",
            "Action": "sagemaker:ListTags",
            "Resource": "arn:aws:sagemaker:*:*:user-profile/*/*"
        }
    ]
}

참고: 위 정책은 예약된 작업으로 태그가 지정된 노트북을 식별할 수 있도록 사용자 프로필의 목록 태그를 허용합니다.

예약된 노트북 작업을 생성하려고 하면 ‘생성’ 버튼이 회색으로 표시됨

생성 버튼이 회색으로 표시되고 추가 옵션 파라미터에 **!**가 표시되는 경우 노트북 작업을 생성할 때 HAR 파일을 검색하십시오. 문제가 발생한 시점의 네트워크 캡처를 검토하여 원인을 식별하십시오. Amazon Virtual Private Cloud(Amazon VPC) 구성 오류 또는 런타임 역할 권한 문제를 확인하십시오.

Amazon VPC를 사용하여 노트북 작업을 실행하는 경우 다음과 같은 Amazon VPC 엔드포인트가 있는지 확인하십시오.

• SageMaker AI: SageMaker AI에 연결하려면 Amazon VPC 인터페이스 엔드포인트를 통해 SageMaker AI에 연결을 참조하십시오.
• Amazon Simple Storage Service(Amazon S3): Amazon S3에 연결하려면 Amazon S3용 게이트웨이 엔드포인트를 참조하십시오.
• Amazon Elastic Compute Cloud(Amazon EC2): Amazon EC2에 연결하려면 인터페이스 VPC 엔드포인트를 사용하여 Amazon EC2에 액세스를 참조하십시오.
• EventBridge: 예약된 노트북을 설정할 때만 EventBridge 엔드포인트를 사용하십시오. EventBridge에 연결하려면 인터페이스 Amazon VPC 엔드포인트와 함께 Amazon EventBridge 사용을 참조하십시오.

하나 이상의 프라이빗 서브넷과 보안 그룹을 지정합니다. 프라이빗 서브넷을 사용하지 않는 경우 다른 구성 옵션을 사용하십시오. 자세한 내용은 VPC 전용 모드 사용을 위한 요구 사항을 참조하십시오.

위 엔드포인트를 구성했거나 Amazon VPC를 사용하여 노트북 작업을 실행하지 않는 경우 IAM 권한 및 런타임 역할 권한을 구성하십시오.

IAM 권한을 구성하려면 다음 단계를 완료하십시오.

1. IAM 콘솔을 엽니다.
2. 탐색 창에서 사용자를 선택합니다.
3. 노트북 작업과 연결된 IAM 사용자를 선택합니다.
4. 드롭다운 메뉴에서 권한 추가를 선택한 다음, 인라인 정책 생성을 선택합니다.
5. JSON 탭을 선택한 후 다음 정책을 추가합니다.

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Sid": "EventBridgeSchedule",
               "Effect": "Allow",
               "Action": [
                   "events:TagResource",
                   "events:DeleteRule",
                   "events:PutTargets",
                   "events:DescribeRule",
                   "events:EnableRule",
                   "events:PutRule",
                   "events:RemoveTargets",
                   "events:DisableRule"
               ],
               "Resource": "*",
               "Condition": {
                   "StringEquals": {
                       "aws:ResourceTag/sagemaker:is-scheduling-notebook-job": "true"
                   }
               }
           },
           {
               "Sid": "IAMPassrole",
               "Effect": "Allow",
               "Action": "iam:PassRole",
               "Resource": "arn:aws:iam::*:role/*",
               "Condition": {
                   "StringLike": {
                       "iam:PassedToService": [
                           "sagemaker.amazonaws.com",
                           "events.amazonaws.com"
                       ]
                   }
               }
           },
           {
               "Sid": "IAMListRoles",
               "Effect": "Allow",
               "Action": "iam:ListRoles",
               "Resource": "*"
           },
           {
               "Sid": "S3ArtifactsAccess",
               "Effect": "Allow",
               "Action": [
                   "s3:PutEncryptionConfiguration",
                   "s3:CreateBucket",
                   "s3:PutBucketVersioning",
                   "s3:ListBucket",
                   "s3:PutObject",
                   "s3:GetObject",
                   "s3:GetEncryptionConfiguration",
                   "s3:DeleteObject",
                   "s3:GetBucketLocation"
               ],
               "Resource": [
                   "arn:aws:s3:::sagemaker-automated-execution-*"
               ]
           },
           {
               "Sid": "S3DriverAccess",
               "Effect": "Allow",
               "Action": [
                   "s3:ListBucket",
                   "s3:GetObject",
                   "s3:GetBucketLocation"
               ],
               "Resource": [
                   "arn:aws:s3:::sagemakerheadlessexecution-*"
               ]
           },
           {
               "Sid": "SagemakerJobs",
               "Effect": "Allow",
               "Action": [
                   "sagemaker:DescribeTrainingJob",
                   "sagemaker:StopTrainingJob",
                   "sagemaker:DescribePipeline",
                   "sagemaker:CreateTrainingJob",
                   "sagemaker:DeletePipeline",
                   "sagemaker:CreatePipeline"
               ],
               "Resource": "*",
               "Condition": {
                   "StringEquals": {
                       "aws:ResourceTag/sagemaker:is-scheduling-notebook-job": "true"
                   }
               }
           },
           {
               "Sid": "AllowSearch",
               "Effect": "Allow",
               "Action": "sagemaker:Search",
               "Resource": "*"
           },
           {
               "Sid": "SagemakerTags",
               "Effect": "Allow",
               "Action": [
                   "sagemaker:ListTags",
                   "sagemaker:AddTags"
               ],
               "Resource": [
                   "arn:aws:sagemaker:*:*:pipeline/*",
                   "arn:aws:sagemaker:*:*:space/*",
                   "arn:aws:sagemaker:*:*:training-job/*",
                   "arn:aws:sagemaker:*:*:user-profile/*"
               ]
           },
           {
               "Sid": "ECRImage",
               "Effect": "Allow",
               "Action": [
                   "ecr:GetAuthorizationToken",
                   "ecr:BatchGetImage"
               ],
               "Resource": "*"
           }
       ]
   }

런타임 역할 권한을 구성하려면 다음 단계를 완료하십시오.

1. IAM 콘솔을 엽니다.
2. 탐색 창에서 역할을 선택합니다.
3. 노트북 작업과 연결된 작업 런타임 역할을 선택합니다.
4. 신뢰 관계 탭을 선택합니다.
5. 신뢰 정책 편집을 선택하고 다음 정책을 추가합니다.

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

리소스에 액세스할 수 있는 권한을 추가하려면 다음 단계를 완료하십시오.

1. IAM 콘솔을 엽니다.

2. 왼쪽 탐색 창에서 역할을 선택합니다.

3. 노트북 작업과 연결된 작업 런타임 역할을 선택합니다.

4. 드롭다운 메뉴에서 권한 추가를 선택한 다음, 인라인 정책 생성을 선택합니다.

5. JSON 탭을 선택한 후 다음 정책을 추가합니다.

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Sid": "PassroleForJobCreation",
               "Effect": "Allow",
               "Action": "iam:PassRole",
               "Resource": "arn:aws:iam::*:role/*",
               "Condition": {
                   "StringLike": {
                       "iam:PassedToService": "sagemaker.amazonaws.com"
                   }
               }
           },
           {
               "Sid": "S3ForStoringArtifacts",
               "Effect": "Allow",
               "Action": [
                   "s3:PutObject",
                   "s3:GetObject",
                   "s3:ListBucket",
                   "s3:GetBucketLocation"
               ],
               "Resource": "arn:aws:s3:::sagemaker-automated-execution-*"
           },
           {
               "Sid": "S3DriverAccess",
               "Effect": "Allow",
               "Action": [
                   "s3:ListBucket",
                   "s3:GetObject",
                   "s3:GetBucketLocation"
               ],
               "Resource": [
                   "arn:aws:s3:::sagemakerheadlessexecution-*"
               ]
           },
           {
               "Sid": "SagemakerJobs",
               "Effect": "Allow",
               "Action": [
                   "sagemaker:StartPipelineExecution",
                   "sagemaker:CreateTrainingJob"
               ],
               "Resource": "*"
           },
           {
               "Sid": "ECRImage",
               "Effect": "Allow",
               "Action": [
                   "ecr:GetDownloadUrlForLayer",
                   "ecr:BatchGetImage",
                   "ecr:GetAuthorizationToken",
                   "ecr:BatchCheckLayerAvailability"
               ],
               "Resource": "*"
           }
       ]
   }

   참고: 위 정책에서는 노트북 작업에서 액세스해야 하는 다른 리소스에 권한을 추가할 수 있습니다.

6. 정책 검토를 선택합니다. 그다음으로 해당 정책 이름을 입력합니다.

7. 정책 생성을 선택합니다.

‘Unable to find metadata for image’ 오류가 발생함

‘Unable to find metadata for image arn in region: example-region’ 오류 메시지가 발생합니다.

위 오류는 노트북 작업을 생성할 때 사용자의 이미지를 연결하거나 선택하지 않으면 발생합니다. 이 오류는 사용자의 이미지를 노트북 작업에 연결하려고 할 때도 발생할 수 있습니다.

이 문제를 해결하려면 나중에 노트북 작업을 다시 예약하십시오. 오류가 계속 발생하면 AWS Support에 문의하십시오.

관련 정보

Amazon SageMaker Studio 노트북을 예정된 노트북 작업으로 운영

로컬 Jupyter 환경에 대한 정책 및 권한 설치