

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon SageMaker AI 계정에 Git 리포지토리 추가
<a name="nbi-git-resource"></a>

**중요**  
Amazon SageMaker Studio 또는 Amazon SageMaker Studio Classic에서 Amazon SageMaker 리소스를 만들도록 허용하는 사용자 지정 IAM 정책은 해당 리소스에 태그를 추가할 수 있는 권한도 부여해야 합니다. Studio와 Studio Classic은 만드는 리소스에 태그를 자동으로 지정하기 때문에 리소스에 태그를 추가할 권한이 필요합니다. IAM 정책이 Studio 및 Studio Classic에서 리소스를 만들도록 허용하지만 태그 지정은 허용하지 않는 경우 리소스 만들기를 시도할 때 'AccessDenied' 오류가 발생할 수 있습니다. 자세한 내용은 [SageMaker AI 리소스 태그 지정을 위한 권한 제공](security_iam_id-based-policy-examples.md#grant-tagging-permissions) 섹션을 참조하세요.  
SageMaker 리소스를 만들 수 있는 권한을 부여하는 [AWS Amazon SageMaker AI에 대한 관리형 정책](security-iam-awsmanpol.md)에는 해당 리소스를 만드는 동안 태그를 추가할 수 있는 권한이 이미 포함되어 있습니다.

GitHub 리포지토리를 관리하기 위해 노트북 인스턴스와 GitHub 리포지토리를 쉽게 연결하고, 인증이 필요한 리포지토리에 대한 자격 증명을 연결하고, Amazon SageMaker AI 계정에서 리포지토리를 리소스로 추가합니다. SageMaker AI 콘솔에서 아니면 API를 사용하여 계정에 저장된 리포지토리 목록과 각 리포지토리에 대한 세부 정보를 확인할 수 있습니다.

SageMaker AI 콘솔 또는 AWS CLI를 사용하여 SageMaker AI 계정에 Git 리포지토리를 추가할 수 있습니다.

**참고**  
SageMaker AI API [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateCodeRepository.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateCodeRepository.html)를 사용하여 SageMaker AI 계정에 Git 리포지토리를 추가할 수 있지만 여기서는 단계별 지침을 제공하지 않습니다.

## SageMaker AI 계정에 Git 리포지토리 추가(콘솔)
<a name="nbi-git-resource-console"></a>

**SageMaker AI 계정에서 Git 리포지토리를 리소스로 추가하는 방법**

1. [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)에서 SageMaker AI 콘솔을 엽니다.

1. **노트북** 아래에 **Git 리포지토리**를 선택하고 **리포지토리 추가**를 선택합니다.

1. CodeCommit 리포지토리를 추가하려면 **AWS CodeCommit**를 선택합니다. GitHub 또는 기타 GIT 기반 리포지토리를 추가하려면 **GitHub/기타 Git 기반 리포지토리**를 선택합니다.

**기존 CodeCommit 리포지토리 추가**

1. **기존 리포지토리 사용**을 선택합니다.

1. **리포지토리**의 경우 목록에서 리포지토리를 선택합니다.

1. SageMaker AI에서 리포지토리에 사용할 이름을 입력합니다. 이름은 1\$163자여야 합니다. 유효한 문자는 a-z, A-Z, 0-9 및 –(하이픈)입니다.

1. **리포지토리 추가**를 선택합니다.

**새 CodeCommit 리포지토리 생성**

1. **새 리포지토리 생성**을 선택합니다.

1. CodeCommit 및 SageMaker AI 둘 다에서 사용할 수 있는 리포지토리 이름을 입력합니다. 이름은 1\$163자여야 합니다. 유효한 문자는 a-z, A-Z, 0-9 및 –(하이픈)입니다.

1. **리포지토리 생성**을 선택합니다.

**CodeCommit 이외의 위치에서 호스팅되는 Git 리포지토리를 추가하려면**

1. **GitHub/기타 Git 기반 리포지토리**를 선택합니다.

1. 최대 63자의 이름을 입력합니다. 유효한 문자에는 영숫자, 하이픈(-) 및 0-9가 포함됩니다.

1. 리포지토리에 대한 URL을 입력합니다. URL에 사용자 이름을 포함하지 마세요. 다음 단계에 설명된 AWS Secrets Manager 대로에 로그인 자격 증명을 추가합니다.

1. **Git 보안 인증 정보**에서, 리포지토리 인증에 사용할 보안 인증 정보를 선택합니다. Git 리포지토리가 프라이빗인 경우에만 필요합니다.
**참고**  
Git 저장소에 대해 2단계 인증을 사용하도록 설정한 경우 Git 서비스 공급자가 생성한 개인 액세스 토큰을 `password`필드에 입력합니다.

   1. 기존 AWS Secrets Manager 보안 암호를 사용하려면 **기존 보안 암호 사용을** 선택한 다음 목록에서 보안 암호를 선택합니다. 비밀 암호 생성 및 저장에 대한 자세한 내용은 *AWS Secrets Manager 사용 설명서*의 [기본 비밀 암호 생성](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html)을 참조하세요. 사용하는 비밀 암호의 이름이 문자열 `sagemaker`를 포함해야 합니다.
**참고**  
암호는 `AWSCURRENT`의 스테이징 레이블을 가지고 있어야 하며 다음 형식이어야 합니다.  
`{"username": UserName, "password": Password}`  
GitHub 리포지토리의 경우 `password`필드에 개인 액세스 토큰을 사용하는 것이 좋습니다. 자세한 정보는 [https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/)을 참조하세요.

   1. 새 AWS Secrets Manager 보안 암호를 생성하려면 **보안 암호 생성을** 선택하고 보안 암호의 이름을 입력한 다음 리포지토리에 인증하는 데 사용할 로그인 자격 증명을 입력합니다. 비밀 암호의 이름이 문자열 `sagemaker`를 포함해야 합니다.
**참고**  
비밀 암호를 생성하는 데 사용하는 IAM 역할에는 IAM 정책에 `secretsmanager:GetSecretValue`권한이 있어야 합니다.  
암호는 `AWSCURRENT`의 스테이징 레이블을 가지고 있어야 하며 다음 형식이어야 합니다.  
`{"username": UserName, "password": Password}`  
GitHub 리포지토리의 경우 개인 액세스 토큰을 사용하는 것이 좋습니다.

   1. 보안 인증 정보를 사용하지 않으려면 **암호 없음**을 선택합니다.

1. **보안 암호 생성**을 선택합니다.

# Amazon SageMaker AI 계정에 Git 리포지토리 추가(CLI)
<a name="nbi-git-resource-cli"></a>

**중요**  
Amazon SageMaker Studio 또는 Amazon SageMaker Studio Classic에서 Amazon SageMaker 리소스를 만들도록 허용하는 사용자 지정 IAM 정책은 해당 리소스에 태그를 추가할 수 있는 권한도 부여해야 합니다. Studio와 Studio Classic은 만드는 리소스에 태그를 자동으로 지정하기 때문에 리소스에 태그를 추가할 권한이 필요합니다. IAM 정책이 Studio 및 Studio Classic에서 리소스를 만들도록 허용하지만 태그 지정은 허용하지 않는 경우 리소스 만들기를 시도할 때 'AccessDenied' 오류가 발생할 수 있습니다. 자세한 내용은 [SageMaker AI 리소스 태그 지정을 위한 권한 제공](security_iam_id-based-policy-examples.md#grant-tagging-permissions) 섹션을 참조하세요.  
SageMaker 리소스를 만들 수 있는 권한을 부여하는 [AWS Amazon SageMaker AI에 대한 관리형 정책](security-iam-awsmanpol.md)에는 해당 리소스를 만드는 동안 태그를 추가할 수 있는 권한이 이미 포함되어 있습니다.

`create-code-repository` AWS CLI 명령을 사용하여 Amazon SageMaker AI에 Git 리포지토리를 추가하여 사용자에게 외부 리소스에 대한 액세스 권한을 부여합니다. `code-repository-name` 인수 값으로 리포지토리의 이름을 지정합니다. 이름은 1\$163자여야 합니다. 유효한 문자는 a-z, A-Z, 0-9 및 –(하이픈)입니다. 또한 다음을 지정합니다.
+ 기본 브랜치
+ Git 리포지토리 URL
**참고**  
URL에 사용자 이름을 포함하지 마세요. 다음 단계에 설명된 AWS Secrets Manager 대로에 로그인 자격 증명을 추가합니다.
+ 리포지토리를 `git-config` 인수 값으로 인증하는 데 사용할 자격 증명이 포함된 AWS Secrets Manager 보안 암호의 Amazon 리소스 이름(ARN)입니다.

비밀 암호 생성 및 저장에 대한 자세한 내용은 *AWS Secrets Manager 사용 설명서*의 [기본 비밀 암호 생성](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html)을 참조하세요. 다음 명령은 Amazon SageMaker AI 계정에 `https://github.com/myprofile/my-repo"`에서 호스팅되는 Git 리포지토리를 가리키는 `MyRespository`라는 새 리포지토리를 생성합니다.

Linux, OS X, Unix의 경우:

```
aws sagemaker create-code-repository \
                    --code-repository-name "MyRepository" \
                    --git-config Branch=branch,RepositoryUrl=https://github.com/myprofile/my-repo,SecretArn=arn:aws:secretsmanager:us-east-2:012345678901:secret:my-secret-ABc0DE
```

Windows의 경우:

```
aws sagemaker create-code-repository ^
                    --code-repository-name "MyRepository" ^
                    --git-config "{\"Branch\":\"master\", \"RepositoryUrl\" :
                    \"https://github.com/myprofile/my-repo\", \"SecretArn\" : \"arn:aws:secretsmanager:us-east-2:012345678901:secret:my-secret-ABc0DE\"}"
```

**참고**  
암호는 `AWSCURRENT`의 스테이징 레이블을 가지고 있어야 하며 다음 형식이어야 합니다.  
`{"username": UserName, "password": Password}`  
GitHub 리포지토리의 경우 개인용 액세스 토큰을 사용하는 것이 좋습니다.