使用關聯的 Git 儲存庫建立筆記本執行個體 (CLI) - Amazon SageMaker AI

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用關聯的 Git 儲存庫建立筆記本執行個體 (CLI)

重要

允許 Amazon SageMaker Studio 或 Amazon SageMaker Studio Classic 建立 Amazon SageMaker 資源的自訂 IAM 政策也必須授予許可，才能將標籤新增至這些資源。需要將標籤新增至資源的許可，因為 Studio 和 Studio Classic 會自動標記他們建立的任何資源。如果 IAM 政策允許 Studio 和 Studio Classic 建立資源，但不允許標記，則嘗試建立資源時可能會發生「AccessDenied」錯誤。如需詳細資訊，請參閱提供標記 SageMaker AI 資源的許可。

AWS Amazon SageMaker AI 的 受管政策 提供建立 SageMaker 資源的許可，已包含建立這些資源時新增標籤的許可。

若要使用 AWS CLI建立筆記本執行個體，並建立 Git 儲存庫的關聯性，請使用 create-notebook-instance 命令，如下所示：

  • 指定要當作預設儲存庫且作為 default-code-repository 引數值的儲存庫。Amazon SageMaker AI 會將此儲存庫複製為 Jupyter 啟動目錄中的子目錄/home/ec2-user/SageMaker。當您開啟筆記本執行個體時，它會在此儲存庫中開啟。若要使用存放為 SageMaker AI 帳戶中資源的儲存庫，請指定儲存庫的名稱做為default-code-repository引數的值。若要使用非存放在帳戶中的儲存庫，請指定儲存庫 URL 做為 default-code-repository 引數的值。

  • 最多指定三個其他儲存庫做為 additional-code-repositories 引數的值。SageMaker AI 會將此儲存庫複製為 Jupyter 啟動目錄中的子目錄/home/ec2-user/SageMaker，並將儲存庫新增至預設儲存庫的.git/info/exclude目錄，將其排除在預設儲存庫之外。若要使用存放為 SageMaker AI 帳戶中資源的儲存庫，請將儲存庫的名稱指定為additional-code-repositories引數的值。若要使用非存放在帳戶中的儲存庫，請指定儲存庫 URL 做為 additional-code-repositories 引數的值。

例如，下列命令會建立筆記本執行個體，其中包含名為 的儲存庫MyGitRepo，以資源形式存放在 SageMaker AI 帳戶中，做為預設儲存庫，以及託管在 GitHub 上的其他儲存庫：

aws sagemaker create-notebook-instance \
                    --notebook-instance-name "MyNotebookInstance" \
                    --instance-type "ml.t2.medium" \
                    --role-arn "arn:aws:iam::012345678901:role/service-role/AmazonSageMaker-ExecutionRole-20181129T121390" \
                    --default-code-repository "MyGitRepo" \
                    --additional-code-repositories "https://github.com/myprofile/my-other-repo"
注意

如果您使用的名稱中不包含 "SageMaker" 的 AWS CodeCommit 儲存庫，請將 codecommit:GitPull和 codecommit:GitPush許可新增至做為 create-notebook-instance 命令引role-arn數傳遞的角色。如需有關將許可新增給角色的資訊，請參閱AWS Identity and Access Management 使用者指南》中的新增和移除 IAM 政策。