Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Repositori Git dengan Instans Notebook SageMaker AI
Kaitkan repositori Git dengan instance notebook Anda untuk menyimpan buku catatan Anda di lingkungan kontrol sumber yang tetap ada meskipun Anda menghentikan atau menghapus instance notebook Anda. Anda dapat mengaitkan satu repositori default dan hingga tiga repositori tambahan dengan instance notebook. Repositori dapat di-host di AWS CodeCommit, GitHub, atau di server Git lainnya. Mengaitkan repositori Git dengan instance notebook Anda dapat berguna untuk:
+ Kegigihan - Notebook dalam instance notebook disimpan pada volume Amazon EBS yang tahan lama, tetapi tidak bertahan melampaui masa pakai instance notebook Anda. Menyimpan buku catatan di repositori Git memungkinkan Anda menyimpan dan menggunakan buku catatan meskipun Anda menghentikan atau menghapus instance buku catatan Anda.
+ Kolaborasi - Rekan dalam tim sering mengerjakan proyek pembelajaran mesin bersama. Menyimpan buku catatan Anda di repositori Git memungkinkan peer yang bekerja di instans notebook yang berbeda untuk berbagi buku catatan dan berkolaborasi dengannya dalam lingkungan kontrol sumber.
+ Pembelajaran - Banyak buku catatan Jupyter yang mendemonstrasikan teknik pembelajaran mesin tersedia di repositori Git yang dihosting publik, seperti on. GitHub Anda dapat mengaitkan instance notebook Anda dengan repositori untuk memuat notebook Jupyter dengan mudah yang terdapat dalam repositori tersebut.
Ada dua cara untuk mengaitkan repositori Git dengan instance notebook:
+ Tambahkan repositori Git sebagai sumber daya di akun Amazon SageMaker AI Anda. Kemudian, untuk mengakses repositori, Anda dapat menentukan AWS rahasia Secrets Manager yang berisi kredensil. Dengan begitu, Anda dapat mengakses repositori yang memerlukan otentikasi.
+ Kaitkan repositori Git publik yang bukan sumber daya di akun Anda. Jika Anda melakukan ini, Anda tidak dapat menentukan kredensi untuk mengakses repositori.
**Topics**
+ [
# Tambahkan repositori Git ke akun Amazon SageMaker AI Anda
](nbi-git-resource.md)
+ [
# Membuat Instance Notebook dengan Repositori Git Terkait
](nbi-git-create.md)
+ [
# Kaitkan CodeCommit Repositori di AWS Akun Berbeda dengan Instance Notebook
](nbi-git-cross.md)
+ [
# Menggunakan Repositori Git dalam Instance Notebook
](git-nbi-use.md)
# Tambahkan repositori Git ke akun Amazon SageMaker AI Anda
**penting**
Kebijakan IAM khusus yang memungkinkan Amazon SageMaker Studio atau Amazon SageMaker Studio Classic membuat SageMaker sumber daya Amazon juga harus memberikan izin untuk menambahkan tag ke sumber daya tersebut. Izin untuk menambahkan tag ke sumber daya diperlukan karena Studio dan Studio Classic secara otomatis menandai sumber daya apa pun yang mereka buat. Jika kebijakan IAM memungkinkan Studio dan Studio Classic membuat sumber daya tetapi tidak mengizinkan penandaan, kesalahan "AccessDenied" dapat terjadi saat mencoba membuat sumber daya. Untuk informasi selengkapnya, lihat [Berikan izin untuk menandai sumber daya AI SageMaker](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS kebijakan terkelola untuk Amazon SageMaker AI](security-iam-awsmanpol.md)yang memberikan izin untuk membuat SageMaker sumber daya sudah menyertakan izin untuk menambahkan tag saat membuat sumber daya tersebut.
Untuk mengelola GitHub repositori Anda, kaitkan dengan mudah dengan instans notebook Anda, dan kaitkan kredensyal untuk repositori yang memerlukan otentikasi, tambahkan repositori sebagai sumber daya di akun Amazon AI Anda. SageMaker Anda dapat melihat daftar repositori yang disimpan di akun Anda dan detail tentang setiap repositori di konsol SageMaker AI dan dengan menggunakan API.
Anda dapat menambahkan repositori Git ke akun SageMaker AI Anda di konsol SageMaker AI atau dengan menggunakan. AWS CLI
**catatan**
Anda dapat menggunakan 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)untuk menambahkan repositori Git ke akun SageMaker AI Anda, tetapi step-by-step instruksi tidak disediakan di sini.
## Tambahkan repositori Git ke akun SageMaker AI Anda (Konsol)
**Untuk menambahkan repositori Git sebagai sumber daya di akun AI Anda SageMaker**
1. Buka konsol SageMaker AI di [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Di bawah **Notebook**, pilih **repositori** Git, lalu pilih **Tambah** repositori.
1. Untuk menambahkan CodeCommit repositori, pilih. **AWS CodeCommit** **Untuk menambahkan GitHub atau repositori berbasis Git lainnya, pilih GitHub /Other Git-based repo.**
**Untuk menambahkan CodeCommit repositori yang ada**
1. Pilih **Gunakan repositori yang ada**.
1. Untuk **Repositori**, pilih repositori dari daftar.
1. Masukkan nama yang akan digunakan untuk repositori di SageMaker AI. Nama harus 1 hingga 63 karakter. Karakter yang valid adalah a-z, A-Z, 0-9, dan - (tanda hubung).
1. Pilih **Menambahkan repositori**.
**Untuk membuat CodeCommit repositori baru**
1. Pilih **Buat repositori baru**.
1. Masukkan nama untuk repositori yang dapat Anda gunakan di keduanya CodeCommit dan SageMaker AI. Nama harus 1 hingga 63 karakter. Karakter yang valid adalah a-z, A-Z, 0-9, dan - (tanda hubung).
1. Pilih **Buat repositori**.
**Untuk menambahkan repositori Git yang dihosting di tempat lain selain CodeCommit**
1. Pilih **GitHub/Repo berbasis Git lainnya**.
1. Masukkan nama hingga 63 karakter. Karakter yang valid termasuk karakter alfa-numerik, tanda hubung (-), dan 0-9.
1. Masukkan URL untuk repositori. Jangan berikan nama pengguna di URL. Tambahkan kredenal masuk AWS Secrets Manager seperti yang dijelaskan pada langkah berikutnya.
1. Untuk **kredensial Git**, pilih kredensil yang akan digunakan untuk mengautentikasi ke repositori. Ini diperlukan hanya jika repositori Git bersifat pribadi.
**catatan**
Jika autentikasi dua faktor diaktifkan untuk repositori Git Anda, masukkan token akses pribadi yang dihasilkan oleh penyedia layanan Git Anda di bidang. `password`
1. Untuk menggunakan AWS rahasia Secrets Manager **yang ada, pilih Gunakan rahasia yang ada**, lalu pilih rahasia dari daftar. Untuk informasi tentang membuat dan menyimpan rahasia, lihat [Membuat Rahasia Dasar](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) di *Panduan Pengguna AWS Secrets Manager*. Nama rahasia yang Anda gunakan harus berisi string`sagemaker`.
**catatan**
Rahasia harus memiliki label penahapan dari `AWSCURRENT` dan harus dalam format berikut:
`{"username": UserName, "password": Password}`
Untuk GitHub repositori, kami sarankan menggunakan token akses pribadi di lapangan. `password` Untuk informasi, lihat [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. Untuk membuat AWS rahasia Secrets Manager baru, pilih **Buat rahasia**, masukkan nama untuk rahasia, lalu masukkan kredenal masuk yang akan digunakan untuk mengautentikasi ke repositori. Nama untuk rahasia harus berisi string`sagemaker`.
**catatan**
Peran IAM yang Anda gunakan untuk membuat rahasia harus memiliki `secretsmanager:GetSecretValue` izin dalam kebijakan IAM-nya.
Rahasia harus memiliki label penahapan dari `AWSCURRENT` dan harus dalam format berikut:
`{"username": UserName, "password": Password}`
Untuk GitHub repositori, kami sarankan menggunakan token akses pribadi.
1. Untuk tidak menggunakan kredensi apa pun, pilih **Tidak ada** rahasia.
1. Pilih **Buat rahasia**.
# Tambahkan repositori Git ke akun Amazon SageMaker AI Anda (CLI)
**penting**
Kebijakan IAM khusus yang memungkinkan Amazon SageMaker Studio atau Amazon SageMaker Studio Classic membuat SageMaker sumber daya Amazon juga harus memberikan izin untuk menambahkan tag ke sumber daya tersebut. Izin untuk menambahkan tag ke sumber daya diperlukan karena Studio dan Studio Classic secara otomatis menandai sumber daya apa pun yang mereka buat. Jika kebijakan IAM memungkinkan Studio dan Studio Classic membuat sumber daya tetapi tidak mengizinkan penandaan, kesalahan "AccessDenied" dapat terjadi saat mencoba membuat sumber daya. Untuk informasi selengkapnya, lihat [Berikan izin untuk menandai sumber daya AI SageMaker](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS kebijakan terkelola untuk Amazon SageMaker AI](security-iam-awsmanpol.md)yang memberikan izin untuk membuat SageMaker sumber daya sudah menyertakan izin untuk menambahkan tag saat membuat sumber daya tersebut.
Gunakan `create-code-repository` AWS CLI perintah untuk menambahkan repositori Git ke Amazon SageMaker AI untuk memberi pengguna akses ke sumber daya eksternal. Tentukan nama untuk repositori sebagai nilai argumen. `code-repository-name` Nama harus 1 hingga 63 karakter. Karakter yang valid adalah a-z, A-Z, 0-9, dan - (tanda hubung). Juga tentukan yang berikut ini:
+ Cabang default
+ URL dari repositori Git
**catatan**
Jangan berikan nama pengguna di URL. Tambahkan kredenal masuk AWS Secrets Manager seperti yang dijelaskan pada langkah berikutnya.
+ Nama Sumber Daya Amazon (ARN) dari AWS rahasia Secrets Manager yang berisi kredensyal yang akan digunakan untuk mengautentikasi repositori sebagai nilai argumen `git-config`
Untuk informasi tentang membuat dan menyimpan rahasia, lihat [Membuat Rahasia Dasar](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) di *Panduan Pengguna AWS Secrets Manager*. Perintah berikut membuat repositori baru bernama `MyRespository` di akun Amazon SageMaker AI Anda yang menunjuk ke repositori Git yang dihosting di. `https://github.com/myprofile/my-repo"`
Untuk Linux, OS X, atau 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
```
Untuk 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\"}"
```
**catatan**
Rahasia harus memiliki label penahapan dari `AWSCURRENT` dan harus dalam format berikut:
`{"username": UserName, "password": Password}`
Untuk GitHub repositori, kami sarankan menggunakan token akses pribadi.
# Membuat Instance Notebook dengan Repositori Git Terkait
**penting**
Kebijakan IAM khusus yang memungkinkan Amazon SageMaker Studio atau Amazon SageMaker Studio Classic membuat SageMaker sumber daya Amazon juga harus memberikan izin untuk menambahkan tag ke sumber daya tersebut. Izin untuk menambahkan tag ke sumber daya diperlukan karena Studio dan Studio Classic secara otomatis menandai sumber daya apa pun yang mereka buat. Jika kebijakan IAM memungkinkan Studio dan Studio Classic membuat sumber daya tetapi tidak mengizinkan penandaan, kesalahan "AccessDenied" dapat terjadi saat mencoba membuat sumber daya. Untuk informasi selengkapnya, lihat [Berikan izin untuk menandai sumber daya AI SageMaker](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS kebijakan terkelola untuk Amazon SageMaker AI](security-iam-awsmanpol.md)yang memberikan izin untuk membuat SageMaker sumber daya sudah menyertakan izin untuk menambahkan tag saat membuat sumber daya tersebut.
Anda dapat mengaitkan repositori Git dengan instance notebook saat Anda membuat instance notebook dengan menggunakan Konsol Manajemen AWS, atau. AWS CLI Jika Anda ingin menggunakan CodeCommit repositori yang berada di AWS akun yang berbeda dari instance notebook, siapkan akses lintas akun untuk repositori. Untuk informasi, lihat [Kaitkan CodeCommit Repositori di AWS Akun Berbeda dengan Instance Notebook](nbi-git-cross.md).
**Topics**
+ [
## Membuat Instance Notebook dengan Repositori Git Terkait (Konsol)
](#nbi-git-create-console)
+ [
# Membuat Instance Notebook dengan Repositori Git Terkait (CLI)
](nbi-git-create-cli.md)
## Membuat Instance Notebook dengan Repositori Git Terkait (Konsol)
**Untuk membuat instance notebook dan mengaitkan repositori Git di konsol Amazon AI SageMaker**
1. Ikuti petunjuk di [Buat Instans SageMaker Notebook Amazon untuk tutorial](gs-setup-working-env.md).
1. Untuk **repositori Git, pilih** repositori Git untuk diasosiasikan dengan instance notebook.
1. Untuk **repositori Default**, pilih repositori yang ingin Anda gunakan sebagai repositori default Anda. SageMaker AI mengkloning repositori ini sebagai subdirektori di direktori startup Jupyter di. `/home/ec2-user/SageMaker` Ketika Anda membuka instance notebook Anda, itu terbuka di repositori ini. Untuk memilih repositori yang disimpan sebagai sumber daya di akun Anda, pilih namanya dari daftar. Untuk menambahkan repositori baru sebagai sumber daya di akun Anda, pilih **Tambahkan repositori ke SageMaker AI (buka alur Tambah repositori di jendela baru) dan kemudian** ikuti instruksi di. [Membuat Instance Notebook dengan Repositori Git Terkait (Konsol)](#nbi-git-create-console) Untuk mengkloning repositori publik yang tidak disimpan di akun Anda, pilih **Kloning repositori Git publik ke instance notebook ini saja, lalu tentukan URL untuk repositori** tersebut.
1. Untuk **Repositori tambahan 1**, pilih repositori yang ingin Anda tambahkan sebagai direktori tambahan. SageMaker AI mengkloning repositori ini sebagai subdirektori di direktori startup Jupyter di. `/home/ec2-user/SageMaker` Untuk memilih repositori yang disimpan sebagai sumber daya di akun Anda, pilih namanya dari daftar. Untuk menambahkan repositori baru sebagai sumber daya di akun Anda, pilih **Tambahkan repositori ke SageMaker AI (buka alur Tambah repositori di jendela baru) dan kemudian** ikuti instruksi di. [Membuat Instance Notebook dengan Repositori Git Terkait (Konsol)](#nbi-git-create-console) Untuk mengkloning repositori yang tidak disimpan di akun Anda, pilih **Kloning repositori Git publik ke instance notebook ini saja, lalu tentukan URL untuk repositori** tersebut.
Ulangi langkah ini hingga tiga kali untuk menambahkan hingga tiga repositori tambahan ke instance notebook Anda.
# Membuat Instance Notebook dengan Repositori Git Terkait (CLI)
**penting**
Kebijakan IAM khusus yang memungkinkan Amazon SageMaker Studio atau Amazon SageMaker Studio Classic membuat SageMaker sumber daya Amazon juga harus memberikan izin untuk menambahkan tag ke sumber daya tersebut. Izin untuk menambahkan tag ke sumber daya diperlukan karena Studio dan Studio Classic secara otomatis menandai sumber daya apa pun yang mereka buat. Jika kebijakan IAM memungkinkan Studio dan Studio Classic membuat sumber daya tetapi tidak mengizinkan penandaan, kesalahan "AccessDenied" dapat terjadi saat mencoba membuat sumber daya. Untuk informasi selengkapnya, lihat [Berikan izin untuk menandai sumber daya AI SageMaker](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS kebijakan terkelola untuk Amazon SageMaker AI](security-iam-awsmanpol.md)yang memberikan izin untuk membuat SageMaker sumber daya sudah menyertakan izin untuk menambahkan tag saat membuat sumber daya tersebut.
Untuk membuat instance notebook dan mengaitkan repositori Git dengan menggunakan AWS CLI, gunakan `create-notebook-instance` perintah sebagai berikut:
+ Tentukan repositori yang ingin Anda gunakan sebagai repositori default Anda sebagai nilai argumen. `default-code-repository` Amazon SageMaker AI mengkloning repositori ini sebagai subdirektori di direktori startup Jupyter di. `/home/ec2-user/SageMaker` Ketika Anda membuka instance notebook Anda, itu terbuka di repositori ini. Untuk menggunakan repositori yang disimpan sebagai sumber daya di akun SageMaker AI Anda, tentukan nama repositori sebagai nilai argumen. `default-code-repository` Untuk menggunakan repositori yang tidak disimpan di akun Anda, tentukan URL repositori sebagai nilai argumen. `default-code-repository`
+ Tentukan hingga tiga repositori tambahan sebagai nilai argumen. `additional-code-repositories` SageMaker AI mengkloning repositori ini sebagai subdirektori di direktori startup Jupyter di`/home/ec2-user/SageMaker`, dan repositori dikecualikan dari repositori default dengan menambahkannya ke direktori repositori default. `.git/info/exclude` Untuk menggunakan repositori yang disimpan sebagai sumber daya di akun SageMaker AI Anda, tentukan nama repositori sebagai nilai argumen. `additional-code-repositories` Untuk menggunakan repositori yang tidak disimpan di akun Anda, tentukan URLs repositori sebagai nilai argumen. `additional-code-repositories`
Misalnya, perintah berikut membuat instance notebook yang memiliki repositori bernama`MyGitRepo`, yang disimpan sebagai sumber daya di akun SageMaker AI Anda, sebagai repositori default, dan repositori tambahan yang di-host di: 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"
```
**catatan**
Jika Anda menggunakan AWS CodeCommit repositori yang tidak berisi "SageMaker" dalam namanya, tambahkan `codecommit:GitPull` dan `codecommit:GitPush` izin ke peran yang Anda berikan sebagai `role-arn` argumen ke perintah. `create-notebook-instance` Untuk informasi tentang cara menambahkan izin ke peran, lihat [Menambahkan dan Menghapus Kebijakan IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) di *AWS Identity and Access Management Panduan Pengguna*.
# Kaitkan CodeCommit Repositori di AWS Akun Berbeda dengan Instance Notebook
Untuk mengaitkan CodeCommit repositori di AWS akun lain dengan instance notebook Anda, siapkan akses lintas akun untuk repositori. CodeCommit
**Untuk mengatur akses lintas akun untuk CodeCommit repositori dan mengaitkannya dengan instance notebook:**
1. Di AWS akun yang berisi CodeCommit repositori, buat kebijakan IAM yang memungkinkan akses ke repositori dari pengguna di akun yang berisi instance notebook Anda. *Untuk selengkapnya, lihat [Langkah 1: Membuat Kebijakan untuk Akses Repositori di Accounta](https://docs.aws.amazon.com/codecommit/latest/userguide/cross-account-administrator-a.html#cross-account-create-policy-a) di Panduan Pengguna. CodeCommit *
1. Di AWS akun yang berisi CodeCommit repositori, buat peran IAM, dan lampirkan kebijakan yang Anda buat di langkah sebelumnya ke peran tersebut. *Untuk selengkapnya, lihat [Langkah 2: Membuat Peran untuk Akses Repositori di Accounta](https://docs.aws.amazon.com/codecommit/latest/userguide/cross-account-administrator-a.html#cross-account-create-role-a) di Panduan Pengguna. CodeCommit *
1. Buat profil di instance buku catatan yang menggunakan peran yang Anda buat di langkah sebelumnya:
1. Buka instance notebook.
1. Buka terminal di instance notebook.
1. Edit profil baru dengan mengetikkan yang berikut di terminal:
```
vi /home/ec2-user/.aws/config
```
1. Edit file dengan informasi profil berikut:
```
[profile CrossAccountAccessProfile]
region = us-west-2
role_arn = arn:aws:iam::CodeCommitAccount:role/CrossAccountRepositoryContributorRole
credential_source=Ec2InstanceMetadata
output = json
```
Di *CodeCommitAccount* mana akun yang berisi CodeCommit repositori, *CrossAccountAccessProfile* adalah nama profil baru, dan *CrossAccountRepositoryContributorRole* merupakan nama peran yang Anda buat pada langkah sebelumnya.
1. Pada instance notebook, konfigurasikan git untuk menggunakan profil yang Anda buat pada langkah sebelumnya:
1. Buka instance notebook.
1. Buka terminal di instance notebook.
1. Edit file konfigurasi Git dengan mengetik berikut ini di terminal:
```
vi /home/ec2-user/.gitconfig
```
1. Edit file dengan informasi profil berikut:
```
[credential]
helper = !aws codecommit credential-helper --profile CrossAccountAccessProfile $@
UseHttpPath = true
```
Di *CrossAccountAccessProfile* mana nama profil yang Anda buat pada langkah sebelumnya.
# Menggunakan Repositori Git dalam Instance Notebook
Saat Anda membuka instance notebook yang memiliki repositori Git yang terkait dengannya, instans tersebut akan terbuka di repositori default, yang dipasang di instance notebook Anda langsung di bawah. `/home/ec2-user/SageMaker` Anda dapat membuka dan membuat buku catatan, dan Anda dapat menjalankan perintah Git secara manual di sel notebook. Contoh:
```
!git pull origin master
```
Untuk membuka salah satu repositori tambahan, navigasikan satu folder. Repositori tambahan juga diinstal sebagai direktori di bawah. `/home/ec2-user/SageMaker`
Jika Anda membuka instance notebook dengan JupyterLab antarmuka, ekstensi jupyter-git diinstal dan tersedia untuk digunakan. [Untuk informasi tentang ekstensi jupyter-git, lihat jupyterlab-git. JupyterLab https://github.com/jupyterlab/](https://github.com/jupyterlab/jupyterlab-git)
Saat Anda membuka instance notebook di JupyterLab, Anda melihat repositori git yang terkait dengannya di menu sebelah kiri:
![\[Contoh file browser di JupyterLab.\]](http://docs.aws.amazon.com/id_id/sagemaker/latest/dg/images/git-notebook.png)
Anda dapat menggunakan ekstensi jupyter-git untuk mengelola git secara visual, alih-alih menggunakan baris perintah:
![\[Contoh ekstensi jupyter-git di. JupyterLab\]](http://docs.aws.amazon.com/id_id/sagemaker/latest/dg/images/jupyterlab-git.png)