

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Tutorial: Gunakan CodeDeploy untuk menyebarkan aplikasi dari GitHub
<a name="tutorials-github"></a>

Dalam tutorial ini, Anda gunakan CodeDeploy untuk menerapkan contoh revisi aplikasi dari GitHub satu instans Amazon EC2 yang menjalankan Amazon Linux, satu instance Red Hat Enterprise Linux (RHEL), atau satu instance Windows Server. Untuk informasi tentang GitHub integrasi dengan CodeDeploy, lihat[Integrasi dengan CodeDeploy GitHub](integrations-partners-github.md).

**catatan**  
Anda juga dapat menggunakan CodeDeploy untuk menyebarkan revisi aplikasi dari GitHub ke instance Server Ubuntu. Anda dapat menggunakan contoh revisi yang dijelaskan [Langkah 2: Buat contoh revisi aplikasi](tutorials-on-premises-instance-2-create-sample-revision.md) dalam[Tutorial: Menerapkan aplikasi ke instans lokal dengan CodeDeploy (Windows Server, Ubuntu Server, atau Red Hat Enterprise Linux)](tutorials-on-premises-instance.md), atau Anda dapat membuat revisi yang kompatibel dengan instance Ubuntu Server dan. CodeDeploy Untuk membuat revisi Anda sendiri, lihat [Rencanakan revisi untuk CodeDeploy](application-revisions-plan.md) dan[Tambahkan file spesifikasi aplikasi ke revisi untuk CodeDeploy](application-revisions-appspec-file.md).

**Topics**
+ [Prasyarat](tutorials-github-prerequisites.md)
+ [Langkah 1: Siapkan GitHub akun](tutorials-github-create-github-account.md)
+ [Langkah 2: Buat GitHub repositori](tutorials-github-create-github-repository.md)
+ [Langkah 3: Unggah contoh aplikasi ke GitHub repositori Anda](tutorials-github-upload-sample-revision.md)
+ [Langkah 4: Menyediakan sebuah instance](tutorials-github-provision-instance.md)
+ [Langkah 5: Buat grup aplikasi dan penyebaran](tutorials-github-create-application.md)
+ [Langkah 6: Menyebarkan aplikasi ke instance](tutorials-github-deploy-application.md)
+ [Langkah 7: Pantau dan verifikasi penyebaran](tutorials-github-verify.md)
+ [Langkah 8: Membersihkan](tutorials-github-clean-up.md)

# Prasyarat
<a name="tutorials-github-prerequisites"></a>

Sebelum Anda memulai tutorial ini, lakukan hal berikut:
+ Instal Git di mesin lokal Anda. Untuk menginstal Git, lihat [Unduhan Git](http://git-scm.com/downloads).
+ Selesaikan langkah-langkahnya[Memulai dengan CodeDeploy](getting-started-codedeploy.md), termasuk menginstal dan mengonfigurasi file. AWS CLI Ini sangat penting jika Anda ingin menggunakan AWS CLI untuk menyebarkan revisi dari GitHub ke instance.

# Langkah 1: Siapkan GitHub akun
<a name="tutorials-github-create-github-account"></a>

Anda akan memerlukan GitHub akun untuk membuat GitHub repositori tempat revisi akan disimpan. Jika Anda sudah memiliki GitHub akun, lompat ke depan[Langkah 2: Buat GitHub repositori](tutorials-github-create-github-repository.md).

1. Pergi [https://github.comke/join](https://github.com).

1. Ketik nama pengguna, alamat email Anda, dan kata sandi.

1. Pilih **Daftar GitHub**, lalu ikuti petunjuknya.

# Langkah 2: Buat GitHub repositori
<a name="tutorials-github-create-github-repository"></a>

Anda akan memerlukan GitHub repositori untuk menyimpan revisi.

Jika Anda sudah memiliki GitHub repositori, pastikan untuk mengganti namanya untuk **CodeDeployGitHubDemo** seluruh tutorial ini, dan kemudian lompat ke depan. [Langkah 3: Unggah contoh aplikasi ke GitHub repositori Anda](tutorials-github-upload-sample-revision.md) 

1. Di [GitHub halaman](https://github.com/dashboard) beranda, lakukan salah satu hal berikut:
   + Di **repositori Anda, pilih Repositori** **baru**.
   + Pada bilah navigasi, pilih **Buat baru** (**\$1**), lalu pilih **Repositori baru**.

1. Di halaman **Buat repositori baru**, lakukan hal berikut:
   + Di kotak **nama Repositori**, masukkan. **CodeDeployGitHubDemo**
   + Pilih **Publik**.
**catatan**  
Memilih opsi **Publik** default berarti siapa pun dapat melihat repositori ini. Anda dapat memilih opsi **Private** untuk membatasi siapa yang dapat melihat dan berkomitmen ke repositori. 
   + Kosongkan kotak **centang Inisialisasi repositori ini dengan README**. Anda akan membuat `README.md` file secara manual di langkah berikutnya sebagai gantinya.
   + Pilih **Buat repositori**.

1. Ikuti instruksi untuk jenis mesin lokal Anda untuk menggunakan baris perintah untuk membuat repositori.
**catatan**  
Jika Anda telah mengaktifkan otentikasi dua faktor GitHub, pastikan Anda memasukkan token akses pribadi alih-alih kata sandi GitHub masuk Anda jika diminta kata sandi. Untuk selengkapnya, lihat [Menyediakan kode autentikasi 2FA Anda](https://help.github.com/articles/providing-your-2fa-authentication-code/).

**Di mesin Linux, macOS, atau Unix lokal:**

1. Dari terminal, jalankan perintah berikut, satu per satu, di *user-name* mana nama GitHub pengguna Anda:

   ```
   mkdir /tmp/CodeDeployGitHubDemo
   ```

   ```
   cd /tmp/CodeDeployGitHubDemo
   ```

   ```
   touch README.md
   ```

   ```
   git init
   ```

   ```
   git add README.md
   ```

   ```
   git commit -m "My first commit"
   ```

   ```
   git remote add origin https://github.com/user-name/CodeDeployGitHubDemo.git
   ```

   ```
   git push -u origin master
   ```

1. Biarkan terminal terbuka di `/tmp/CodeDeployGitHubDemo` lokasi.

**Di mesin Windows lokal:**

1. Dari command prompt yang berjalan sebagai administrator, jalankan perintah berikut, satu per satu:

   ```
   mkdir c:\temp\CodeDeployGitHubDemo
   ```

   ```
   cd c:\temp\CodeDeployGitHubDemo
   ```

   ```
   notepad README.md
   ```

1. Di Notepad, simpan file. `README.md` Tutup Notepad. Jalankan perintah berikut, satu per satu, di *user-name* mana nama GitHub pengguna Anda:

   ```
   git init
   ```

   ```
   git add README.md
   ```

   ```
   git commit -m "My first commit"
   ```

   ```
   git remote add origin https://github.com/user-name/CodeDeployGitHubDemo.git
   ```

   ```
   git push -u origin master
   ```

1. Biarkan command prompt terbuka di `c:\temp\CodeDeployGitHubDemo` lokasi.

# Langkah 3: Unggah contoh aplikasi ke GitHub repositori Anda
<a name="tutorials-github-upload-sample-revision"></a>

Pada langkah ini, Anda akan menyalin revisi sampel dari bucket Amazon S3 publik ke GitHub repositori Anda. (Untuk kesederhanaan, contoh revisi yang disediakan untuk tutorial ini adalah halaman web tunggal.)

**catatan**  
Jika Anda menggunakan salah satu revisi Anda alih-alih revisi sampel kami, revisi Anda harus:   
Ikuti pedoman di [Rencanakan revisi untuk CodeDeploy](application-revisions-plan.md) dan[Tambahkan file spesifikasi aplikasi ke revisi untuk CodeDeploy](application-revisions-appspec-file.md).
Bekerja dengan jenis instance yang sesuai.
Dapat diakses dari GitHub dasbor Anda.
Jika revisi Anda memenuhi persyaratan ini, lanjutkan ke[Langkah 5: Buat grup aplikasi dan penyebaran](tutorials-github-create-application.md).  
Jika Anda menerapkan ke instance Server Ubuntu, Anda harus mengunggah ke GitHub repositori Anda revisi yang kompatibel dengan instance Server Ubuntu dan. CodeDeploy Untuk informasi selengkapnya, lihat [Rencanakan revisi untuk CodeDeploy](application-revisions-plan.md) dan [Tambahkan file spesifikasi aplikasi ke revisi untuk CodeDeploy](application-revisions-appspec-file.md).

**Topics**
+ [Dorong revisi sampel dari mesin Linux, macOS, atau Unix lokal](#tutorials-github-upload-sample-revision-unixes)
+ [Dorong revisi sampel dari mesin Windows lokal](#tutorials-github-upload-sample-revision-windows)

## Dorong revisi sampel dari mesin Linux, macOS, atau Unix lokal
<a name="tutorials-github-upload-sample-revision-unixes"></a>

Dengan terminal Anda masih terbuka, misalnya, `/tmp/CodeDeployGitHubDemo` lokasi, jalankan perintah berikut satu per satu: 

**catatan**  
Jika Anda berencana untuk menyebarkan ke instance Windows Server, gantilah `SampleApp_Windows.zip` `SampleApp_Linux.zip` dalam perintah.

```
(Amazon S3 copy command)
```

```
unzip SampleApp_Linux.zip
```

```
rm SampleApp_Linux.zip
```

 

```
git add .
```

```
git commit -m "Added sample app"
```

```
git push
```

*(Amazon S3 copy command)*Dimana salah satu dari berikut ini: 
+ `aws s3 cp s3://aws-codedeploy-us-east-2/samples/latest/SampleApp_Linux.zip . --region us-east-2`untuk wilayah AS Timur (Ohio)
+ `aws s3 cp s3://aws-codedeploy-us-east-1/samples/latest/SampleApp_Linux.zip . --region us-east-1`untuk wilayah AS Timur (Virginia N.)
+ `aws s3 cp s3://aws-codedeploy-us-west-1/samples/latest/SampleApp_Linux.zip . --region us-west-1`untuk Wilayah AS Barat (California Utara)
+ `aws s3 cp s3://aws-codedeploy-us-west-2/samples/latest/SampleApp_Linux.zip . --region us-west-2`untuk wilayah AS Barat (Oregon)
+ `aws s3 cp s3://aws-codedeploy-ca-central-1/samples/latest/SampleApp_Linux.zip . --region ca-central-1`untuk Wilayah Kanada (Tengah)
+ `aws s3 cp s3://aws-codedeploy-eu-west-1/samples/latest/SampleApp_Linux.zip . --region eu-west-1`untuk wilayah Eropa (Irlandia) 
+ `aws s3 cp s3://aws-codedeploy-eu-west-2/samples/latest/SampleApp_Linux.zip . --region eu-west-2`untuk wilayah Eropa (London) 
+ `aws s3 cp s3://aws-codedeploy-eu-west-3/samples/latest/SampleApp_Linux.zip . --region eu-west-3`untuk wilayah Eropa (Paris) 
+ `aws s3 cp s3://aws-codedeploy-eu-central-1/samples/latest/SampleApp_Linux.zip . --region eu-central-1`untuk Wilayah Eropa (Frankfurt)
+ `aws s3 cp s3://aws-codedeploy-il-central-1/samples/latest/SampleApp_Linux.zip . --region il-central-1`untuk Wilayah Israel (Tel Aviv)
+ `aws s3 cp s3://aws-codedeploy-ap-east-1/samples/latest/SampleApp_Linux.zip . --region ap-east-1`untuk wilayah Asia Pasifik (Hong Kong)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-1/samples/latest/SampleApp_Linux.zip . --region ap-northeast-1`untuk wilayah Asia Pasifik (Tokyo)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-2/samples/latest/SampleApp_Linux.zip . --region ap-northeast-2`untuk wilayah Asia Pasifik (Seoul)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-1/samples/latest/SampleApp_Linux.zip . --region ap-southeast-1`untuk Wilayah Asia Pasifik (Singapura)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-2/samples/latest/SampleApp_Linux.zip . --region ap-southeast-2`untuk wilayah Asia Pasifik (Sydney)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-4/samples/latest/SampleApp_Linux.zip . --region ap-southeast-4`untuk wilayah Asia Pasifik (Melbourne)
+ `aws s3 cp s3://aws-codedeploy-ap-south-1/samples/latest/SampleApp_Linux.zip . --region ap-south-1`untuk wilayah Asia Pasifik (Mumbai)
+ `aws s3 cp s3://aws-codedeploy-sa-east-1/samples/latest/SampleApp_Linux.zip . --region sa-east-1`untuk Wilayah Amerika Selatan (São Paulo)

## Dorong revisi sampel dari mesin Windows lokal
<a name="tutorials-github-upload-sample-revision-windows"></a>

 Dengan prompt perintah Anda masih terbuka, misalnya, `c:\temp\CodeDeployGitHubDemo` lokasi, jalankan perintah berikut satu per satu:

**catatan**  
Jika Anda berencana untuk menyebarkan ke instans Amazon Linux atau RHEL, gantilah `SampleApp_Linux.zip` `SampleApp_Windows.zip` dalam perintah.

```
(Amazon S3 copy command)
```

Buka zip isi file ZIP langsung ke direktori lokal (misalnya`c:\temp\CodeDeployGitHubDemo`), bukan ke subdirektori baru. `the`

```
git add .
```

```
git commit -m "Added sample app"
```

```
git push
```

*(Amazon S3 copy command)*Dimana salah satu dari berikut ini: 
+ `aws s3 cp s3://aws-codedeploy-us-east-2/samples/latest/SampleApp_Windows.zip . --region us-east-2`untuk wilayah AS Timur (Ohio)
+ `aws s3 cp s3://aws-codedeploy-us-east-1/samples/latest/SampleApp_Windows.zip . --region us-east-1`untuk wilayah AS Timur (Virginia N.)
+ `aws s3 cp s3://aws-codedeploy-us-west-1/samples/latest/SampleApp_Windows.zip . --region us-west-1`untuk Wilayah AS Barat (California Utara)
+ `aws s3 cp s3://aws-codedeploy-us-west-2/samples/latest/SampleApp_Windows.zip . --region us-west-2`untuk wilayah AS Barat (Oregon)
+ `aws s3 cp s3://aws-codedeploy-ca-central-1/samples/latest/SampleApp_Windows.zip . --region ca-central-1`untuk Wilayah Kanada (Tengah)
+ `aws s3 cp s3://aws-codedeploy-eu-west-1/samples/latest/SampleApp_Windows.zip . --region eu-west-1`untuk wilayah Eropa (Irlandia)
+ `aws s3 cp s3://aws-codedeploy-eu-west-2/samples/latest/SampleApp_Windows.zip . --region eu-west-2`untuk wilayah Eropa (London)
+ `aws s3 cp s3://aws-codedeploy-eu-west-3/samples/latest/SampleApp_Windows.zip . --region eu-west-3`untuk wilayah Eropa (Paris)
+ `aws s3 cp s3://aws-codedeploy-eu-central-1/samples/latest/SampleApp_Windows.zip . --region eu-central-1`untuk Wilayah Eropa (Frankfurt)
+ `aws s3 cp s3://aws-codedeploy-il-central-1/samples/latest/SampleApp_Windows.zip . --region il-central-1`untuk Wilayah Israel (Tel Aviv)
+ `aws s3 cp s3://aws-codedeploy-ap-east-1/samples/latest/SampleApp_Windows.zip . --region ap-east-1`untuk wilayah Asia Pasifik (Hong Kong)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-1/samples/latest/SampleApp_Windows.zip . --region ap-northeast-1`untuk wilayah Asia Pasifik (Tokyo)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-2/samples/latest/SampleApp_Windows.zip . --region ap-northeast-2`untuk wilayah Asia Pasifik (Seoul)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-1/samples/latest/SampleApp_Windows.zip . --region ap-southeast-1`untuk Wilayah Asia Pasifik (Singapura)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-2/samples/latest/SampleApp_Windows.zip . --region ap-southeast-2`untuk wilayah Asia Pasifik (Sydney)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-4/samples/latest/SampleApp_Windows.zip . --region ap-southeast-4`untuk wilayah Asia Pasifik (Melbourne)
+ `aws s3 cp s3://aws-codedeploy-ap-south-1/samples/latest/SampleApp_Windows.zip . --region ap-south-1`untuk wilayah Asia Pasifik (Mumbai)
+ `aws s3 cp s3://aws-codedeploy-sa-east-1/samples/latest/SampleApp_Windows.zip . --region sa-east-1`untuk Wilayah Amerika Selatan (São Paulo)

Untuk mendorong revisi Anda sendiri ke instance Server Ubuntu, salin revisi Anda ke repo lokal Anda, lalu panggil yang berikut ini:

```
git add .
git commit -m "Added Ubuntu app"
git push
```

# Langkah 4: Menyediakan sebuah instance
<a name="tutorials-github-provision-instance"></a>

Pada langkah ini, Anda akan membuat atau mengonfigurasi instance yang akan Anda gunakan untuk aplikasi sampel. Anda dapat menerapkan ke instans Amazon EC2 atau instans lokal yang menjalankan salah satu sistem operasi yang didukung oleh. CodeDeploy Untuk informasi lihat[Sistem operasi yang didukung oleh CodeDeploy agen](codedeploy-agent.md#codedeploy-agent-supported-operating-systems). (Jika Anda sudah memiliki instance yang dikonfigurasi untuk digunakan dalam CodeDeploy penerapan, lewati ke langkah berikutnya.)

**Untuk menyediakan sebuah instance**

1. Ikuti instruksi [Luncurkan instans Amazon EC2 (konsol)](instances-ec2-create.md#instances-ec2-create-console) untuk menyediakan instance.

1. Saat meluncurkan instance, ingatlah untuk menentukan tag pada halaman **Tambahkan tag**. Untuk detail tentang cara menentukan tag, lihat[Luncurkan instans Amazon EC2 (konsol)](instances-ec2-create.md#instances-ec2-create-console).

**Untuk memverifikasi bahwa CodeDeploy agen berjalan pada instance**
+ Ikuti instruksi [Verifikasi CodeDeploy agen sedang berjalan](codedeploy-agent-operations-verify.md) untuk memverifikasi bahwa agen sedang berjalan.

Setelah Anda berhasil menyediakan instance dan memverifikasi bahwa CodeDeploy agen sedang berjalan, lanjutkan ke langkah berikutnya.

# Langkah 5: Buat grup aplikasi dan penyebaran
<a name="tutorials-github-create-application"></a>

Pada langkah ini, Anda akan menggunakan CodeDeploy konsol atau AWS CLI untuk membuat aplikasi dan grup penyebaran untuk digunakan untuk menyebarkan revisi sampel dari repositori Anda. GitHub 



## Buat grup aplikasi dan penyebaran (konsol)
<a name="tutorials-github-create-application-console"></a>

1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**  
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).

1. **Di panel navigasi, perluas **Deploy**, lalu pilih Applications.**

   

1. Pilih **Buat aplikasi**, lalu pilih **Aplikasi kustom**.

1. Dalam **nama Aplikasi**, masukkan**CodeDeployGitHubDemo-App**.

1. Di **Compute Platform**, pilih **EC2/On-premise**.

1. Pilih **Create application** (Buat aplikasi).

1. Pada tab **Deployment groups**, pilih **Create deployment** group.

1. Dalam **nama grup Deployment**, masukkan**CodeDeployGitHubDemo-DepGrp**.

1. Di **peran Layanan**, pilih nama peran CodeDeploy layanan yang Anda buat di [Buat peran layanan CodeDeploy](getting-started-create-service-role.md).

1. Di **tipe Deployment**, pilih **In-place**.

1. **Dalam **konfigurasi Lingkungan**, tergantung pada jenis instans yang Anda gunakan, pilih instans **Amazon EC2 atau Instans lokal**.** Untuk **Key** dan **Value**, masukkan kunci tag instance dan nilai yang diterapkan ke instance Anda sebagai bagian dari[Langkah 4: Menyediakan sebuah instance](tutorials-github-provision-instance.md).

1. **Dalam **konfigurasi Deployment**, pilihCodeDeployDefault. AllatOnce**.

1. Di **Load Balancer**, hapus **Aktifkan penyeimbangan beban**.

1. Perluas **Lanjutan**.

1. Di **Alarm**, pilih **Abaikan konfigurasi alarm**.

1. Pilih **Buat grup penyebaran**, dan lanjutkan ke langkah berikutnya. 

## Buat grup aplikasi dan penyebaran (CLI)
<a name="tutorials-github-create-application-cli"></a>

1. Panggil **create-application** perintah untuk membuat aplikasi CodeDeploy bernama`CodeDeployGitHubDemo-App`:

   ```
   aws deploy create-application --application-name CodeDeployGitHubDemo-App
   ```

1. Panggil **create-deployment-group** perintah untuk membuat grup penyebaran bernama`CodeDeployGitHubDemo-DepGrp`:
   + Jika Anda menerapkan ke instans Amazon EC2*ec2-tag-key*, adalah kunci tag instans Amazon EC2 yang diterapkan ke instans Amazon EC2 Anda sebagai bagian dari. [Langkah 4: Menyediakan sebuah instance](tutorials-github-provision-instance.md)
   + Jika Anda menerapkan ke instans Amazon EC2*ec2-tag-value*, adalah nilai tag instans Amazon EC2 yang diterapkan ke instans Amazon EC2 Anda sebagai bagian dari. [Langkah 4: Menyediakan sebuah instance](tutorials-github-provision-instance.md)
   + Jika Anda menerapkan ke instans lokal, *on-premises-tag-key* adalah kunci tag instans lokal yang diterapkan ke instans lokal Anda sebagai bagian dari. [Langkah 4: Menyediakan sebuah instance](tutorials-github-provision-instance.md)
   + Jika Anda menerapkan ke instans lokal, *on-premises-tag-value* adalah nilai tag instans lokal yang diterapkan ke instans lokal Anda sebagai bagian dari. [Langkah 4: Menyediakan sebuah instance](tutorials-github-provision-instance.md)
   + *service-role-arn*adalah ARN peran layanan untuk peran layanan yang Anda buat di [Buat peran layanan](getting-started-create-service-role.md). CodeDeploy (Ikuti instruksi [Dapatkan peran layanan ARN (CLI)](getting-started-create-service-role.md#getting-started-get-service-role-cli) untuk menemukan peran layanan ARN.)

   ```
   aws deploy create-deployment-group --application-name CodeDeployGitHubDemo-App --ec2-tag-filters Key=ec2-tag-key,Type=KEY_AND_VALUE,Value=ec2-tag-value --on-premises-tag-filters Key=on-premises-tag-key,Type=KEY_AND_VALUE,Value=on-premises-tag-value --deployment-group-name CodeDeployGitHubDemo-DepGrp --service-role-arn service-role-arn
   ```
**catatan**  
[create-deployment-group](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment-group.html)Perintah ini menyediakan dukungan untuk membuat pemicu yang menghasilkan pengiriman notifikasi Amazon SNS ke pelanggan topik tentang peristiwa tertentu dalam penerapan dan instance. Perintah ini juga mendukung opsi untuk memutar kembali penerapan secara otomatis dan mengatur alarm untuk menghentikan penerapan saat memantau ambang batas di alarm Amazon terpenuhi. CloudWatch Perintah untuk tindakan ini tidak termasuk dalam tutorial ini.

# Langkah 6: Menyebarkan aplikasi ke instance
<a name="tutorials-github-deploy-application"></a>

Pada langkah ini, Anda menggunakan CodeDeploy konsol atau AWS CLI untuk menerapkan revisi sampel dari GitHub repositori Anda ke instance Anda. 



## Untuk menyebarkan revisi (konsol)
<a name="tutorials-github-deploy-application-console"></a>

1. Pada halaman **Detail grup Deployment**, pilih **Create deployment**.

1. Di **grup Deployment**, pilih **`CodeDeployGitHubDemo-DepGrp`**.

1. Dalam **jenis Revisi**, pilih **GitHub**.

1. Di **Connect to GitHub**, lakukan salah satu hal berikut:
   + Untuk membuat koneksi untuk CodeDeploy aplikasi ke GitHub akun, keluar dari GitHub tab browser web terpisah. Di **GitHub akun**, masukkan nama untuk mengidentifikasi koneksi ini, lalu pilih **Connect to GitHub**. Halaman web meminta Anda untuk mengotorisasi CodeDeploy untuk berinteraksi dengan aplikasi GitHub bernama. `CodeDeployGitHubDemo-App` Lanjutkan ke langkah 5.
   + Untuk menggunakan koneksi yang telah Anda buat, di **GitHubakun**, pilih namanya, lalu pilih **Connect to GitHub**. Lanjutkan ke langkah 7.
   + Untuk membuat koneksi ke GitHub akun lain, keluar dari GitHub tab browser web terpisah. Pilih **Connect ke GitHub akun lain**, lalu pilih **Connect to GitHub**. Lanjutkan ke langkah 5.

1. Ikuti petunjuk di halaman **Masuk** untuk masuk dengan GitHub akun Anda.

1. Pada halaman **Otorisasi aplikasi**, pilih **Otorisasi** aplikasi. 

1. Pada halaman CodeDeploy **Create deployment**, dalam **nama Repositori**, masukkan nama GitHub pengguna yang Anda gunakan untuk masuk, diikuti dengan garis miring (`/`), diikuti dengan nama repositori tempat Anda mendorong revisi aplikasi Anda (misalnya,). ***my-github-user-name*/CodeDeployGitHubDemo**

   Jika Anda tidak yakin nilai yang akan dimasukkan, atau jika Anda ingin menentukan repositori yang berbeda:

   1. Di tab browser web terpisah, buka [GitHub dasbor](https://github.com/dashboard) Anda.

   1. Di **repositori Anda**, arahkan kursor mouse Anda ke nama repositori target. Tooltip muncul, menampilkan nama GitHub pengguna atau organisasi, diikuti dengan garis miring (`/`), diikuti dengan nama repositori. Masukkan nilai ini ke dalam nama **Repositori**.
**catatan**  
Jika nama repositori target tidak ditampilkan di **repositori Anda, gunakan GitHub kotak **Pencarian** untuk menemukan repositori** target dan nama pengguna atau organisasi. GitHub 

1. Di kotak **Commit ID**, masukkan ID komit yang terkait dengan push revisi aplikasi Anda. GitHub

   Jika Anda tidak yakin dengan nilai yang akan dimasukkan:

   1. Di tab browser web terpisah, buka [GitHub dasbor](https://github.com/dashboard) Anda.

   1. Di **repositori Anda, pilih**. **CodeDeployGitHubDemo**

   1. Dalam daftar komit, temukan dan salin ID komit yang terkait dengan push revisi aplikasi Anda. GitHub ID ini biasanya memiliki panjang 40 karakter dan terdiri dari huruf dan angka. (Jangan gunakan versi yang lebih pendek dari ID komit, yang biasanya merupakan 10 karakter pertama dari versi yang lebih panjang.)

   1. Rekatkan ID komit ke dalam kotak **ID Komit**.

1. Pilih **Deploy**, dan lanjutkan ke langkah berikutnya. 

## Untuk menyebarkan revisi (CLI)
<a name="tutorials-github-deploy-application-cli"></a>

Sebelum Anda dapat memanggil AWS CLI perintah apa pun yang berinteraksi dengan GitHub (seperti **create-deployment** perintah, yang akan Anda panggil berikutnya), Anda harus memberikan CodeDeploy izin untuk menggunakan akun GitHub pengguna Anda GitHub untuk berinteraksi dengan `CodeDeployGitHubDemo-App` aplikasi. Saat ini, Anda harus menggunakan CodeDeploy konsol untuk melakukan ini.

1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**  
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).

1. **Di panel navigasi, perluas **Deploy**, lalu pilih Applications.**

   

1. Pilih **CodeDeployGitHubDemo-App**.

1. Pada tab **Deployment**, pilih **Create** deployment.
**catatan**  
Anda tidak akan membuat penyebaran baru. Ini saat ini satu-satunya cara untuk memberikan CodeDeploy izin untuk berinteraksi dengan GitHub atas nama akun GitHub pengguna Anda.

1. Dari **grup Deployment**, pilih **CodeDeployGitHubDemo- DepGrp**.

1. Dalam **jenis Revisi**, pilih **GitHub**.

1. Di **Connect to GitHub**, lakukan salah satu hal berikut:
   + Untuk membuat koneksi untuk CodeDeploy aplikasi ke GitHub akun, keluar dari GitHub tab browser web terpisah. Di **GitHub akun**, ketikkan nama untuk mengidentifikasi koneksi ini, lalu pilih **Connect to GitHub**. Halaman web meminta Anda untuk mengotorisasi CodeDeploy untuk berinteraksi dengan GitHub aplikasi bernama. `CodeDeployGitHubDemo-App` Lanjutkan ke langkah 8.
   + Untuk menggunakan koneksi yang telah Anda buat, di **GitHubakun**, pilih namanya, lalu pilih **Connect to GitHub**. Lanjutkan ke langkah 10.
   + Untuk membuat koneksi ke GitHub akun lain, keluar dari GitHub tab browser web terpisah. Pilih **Connect ke GitHub akun lain**, lalu pilih **Connect to GitHub**. Lanjutkan ke langkah 8.

1. Ikuti petunjuk pada halaman **Masuk** untuk masuk dengan nama GitHub pengguna atau email dan kata sandi Anda.

1. Pada halaman **Otorisasi aplikasi**, pilih **Otorisasi** aplikasi. 

1. Pada halaman CodeDeploy **Create deployment**, pilih **Cancel**.

1. Panggil **create-deployment** perintah untuk menyebarkan revisi dari GitHub repositori Anda ke instance, di mana:
   + *repository*adalah nama GitHub akun Anda, diikuti dengan garis miring maju (`/`), diikuti dengan nama repositori Anda (`CodeDeployGitHubDemo`), misalnya,. `MyGitHubUserName/CodeDeployGitHubDemo`

     Jika Anda tidak yakin nilai yang akan digunakan, atau jika Anda ingin menentukan repositori yang berbeda:

     1. Di tab browser web terpisah, buka [GitHub dasbor](https://github.com/dashboard) Anda.

     1. Di **repositori Anda**, arahkan kursor mouse Anda ke nama repositori target. Tooltip muncul, menampilkan nama GitHub pengguna atau organisasi, diikuti dengan garis miring (`/`), diikuti dengan nama repositori. Ini adalah nilai untuk digunakan.
**catatan**  
Jika nama repositori target tidak muncul di **repositori Anda, gunakan GitHub kotak **Pencarian** untuk menemukan repositori** target dan nama pengguna atau organisasi yang sesuai. GitHub 
   + *commit-id*adalah komit yang terkait dengan versi revisi aplikasi yang Anda dorong ke repositori Anda (misalnya,). `f835159a...528eb76f` 

     Jika Anda tidak yakin dengan nilai yang akan digunakan:

     1. Di tab browser web terpisah, buka [GitHub dasbor](https://github.com/dashboard) Anda.

     1. Di **repositori Anda, pilih**. **CodeDeployGitHubDemo**

     1. Dalam daftar komit, temukan ID komit yang terkait dengan push revisi aplikasi Anda. GitHub ID ini biasanya memiliki panjang 40 karakter dan terdiri dari huruf dan angka. (Jangan gunakan versi yang lebih pendek dari ID komit, yang biasanya merupakan 10 karakter pertama dari versi yang lebih panjang.) Gunakan nilai ini.

   Jika Anda bekerja pada mesin Linux, macOS, atau Unix lokal:

   ```
   aws deploy create-deployment \
     --application-name CodeDeployGitHubDemo-App \
     --deployment-config-name CodeDeployDefault.OneAtATime \
     --deployment-group-name CodeDeployGitHubDemo-DepGrp \
     --description "My GitHub deployment demo" \
     --github-location repository=repository,commitId=commit-id
   ```

   Jika Anda bekerja pada mesin Windows lokal:

   ```
   aws deploy create-deployment --application-name CodeDeployGitHubDemo-App --deployment-config-name CodeDeployDefault.OneAtATime --deployment-group-name CodeDeployGitHubDemo-DepGrp --description "My GitHub deployment demo" --github-location repository=repository,commitId=commit-id
   ```

# Langkah 7: Pantau dan verifikasi penyebaran
<a name="tutorials-github-verify"></a>

Pada langkah ini, Anda akan menggunakan CodeDeploy konsol atau AWS CLI untuk memverifikasi keberhasilan penerapan. Anda akan menggunakan browser web Anda untuk melihat halaman web yang digunakan ke instance yang Anda buat atau konfigurasikan.

**catatan**  
Jika Anda menerapkan ke instance Server Ubuntu, gunakan strategi pengujian Anda sendiri untuk menentukan apakah revisi yang diterapkan berfungsi seperti yang diharapkan pada instance, dan kemudian lanjutkan ke langkah berikutnya.

**Untuk memantau dan memverifikasi penyebaran (konsol)**

1. **Di panel navigasi, perluas **Deploy, lalu pilih Deployments**.**

   

1. **Dalam daftar penerapan, cari baris dengan nilai **Application CodeDeployGitHubDemo** **-App** dan nilai **Grup Deployment** dari -. CodeDeployGitHubDemo DepGrp** Jika **Berhasil** atau **Gagal** tidak muncul di kolom **Status**, pilih tombol **Refresh** secara berkala.

1. Jika **Gagal** muncul di kolom **Status**, ikuti petunjuk [Lihat detail contoh (konsol)](instances-view-details.md#instances-view-details-console) untuk memecahkan masalah penerapan.

1. Jika **Berhasil** muncul di kolom **Status**, Anda sekarang dapat memverifikasi penyebaran melalui browser web Anda. Revisi sampel kami menyebarkan satu halaman web ke instance. Jika Anda menerapkan ke instans Amazon EC2, di browser web Anda, buka `http://public-dns` misalnya (misalnya`http://ec2-01-234-567-890.compute-1.amazonaws.com`,).

1. Jika Anda dapat melihat halaman web, maka selamat\$1 Sekarang setelah Anda AWS CodeDeploy berhasil menggunakan revisi dari GitHub, Anda dapat melompat ke depan. [Langkah 8: Membersihkan](tutorials-github-clean-up.md)

**Untuk memantau dan memverifikasi penyebaran (CLI)**

1. Panggil **list-deployments** perintah untuk mendapatkan ID penyebaran untuk aplikasi bernama `CodeDeployGitHubDemo-App` dan grup penyebaran bernama: `CodeDeployGitHubDemo-DepGrp`

   ```
   aws deploy list-deployments --application-name CodeDeployGitHubDemo-App --deployment-group-name CodeDeployGitHubDemo-DepGrp --query "deployments" --output text
   ```

1. Panggil **get-deployment** perintah, memasok ID penyebaran dalam output dari perintah: **list-deployments**

   ```
   aws deploy get-deployment --deployment-id deployment-id --query "deploymentInfo.[status, creator]" --output text
   ```

1. Jika **Gagal** dikembalikan, ikuti instruksi [Lihat detail contoh (konsol)](instances-view-details.md#instances-view-details-console) untuk memecahkan masalah penerapan.

1. Jika **Succeeded** dikembalikan, Anda sekarang dapat mencoba memverifikasi penyebaran melalui browser web Anda. Revisi sampel kami adalah satu halaman web yang digunakan untuk instance. Jika Anda menerapkan ke instans Amazon EC2, Anda dapat melihat halaman ini di browser web Anda dengan membuka `http://public-dns` instans Amazon EC2 (misalnya,). `http://ec2-01-234-567-890.compute-1.amazonaws.com`

1. Jika Anda dapat melihat halaman web, maka selamat\$1 Anda telah berhasil digunakan AWS CodeDeploy untuk menyebarkan dari GitHub repositori Anda.

# Langkah 8: Membersihkan
<a name="tutorials-github-clean-up"></a>

Untuk menghindari biaya lebih lanjut untuk sumber daya yang Anda gunakan selama tutorial ini, Anda harus menghentikan instans Amazon EC2 dan sumber daya yang terkait. Secara opsional, Anda dapat menghapus catatan komponen CodeDeploy penyebaran yang terkait dengan tutorial ini. Jika Anda menggunakan GitHub repositori hanya untuk tutorial ini, Anda dapat menghapusnya sekarang juga.

## Untuk menghapus CloudFormation tumpukan (jika Anda menggunakan CloudFormation template untuk membuat instans Amazon EC2)
<a name="tutorials-github-clean-up-cloudformation-template"></a>

1. Masuk ke Konsol Manajemen AWS dan buka CloudFormation konsol di [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).

1. Di kolom **Stacks**, pilih tumpukan yang dimulai dengan`CodeDeploySampleStack`.

1. Pilih **Hapus**.

1. Saat diminta, pilih **Hapus tumpukan**. Instans Amazon EC2 dan profil instans IAM terkait serta peran layanan dihapus.

## Untuk membatalkan pendaftaran dan membersihkan instans lokal secara manual (jika Anda menyediakan instans lokal)
<a name="tutorials-github-clean-up-on-premises-instance"></a>

1. Gunakan perintah AWS CLI untuk memanggil perintah [deregister](https://docs.aws.amazon.com/cli/latest/reference/deploy/deregister.html) terhadap instance lokal yang diwakili di sini oleh *your-instance-name* dan wilayah terkait dengan: *your-region*

   ```
   aws deploy deregister --instance-name your-instance-name --no-delete-iam-user --region your-region
   ```

1. Dari instance lokal, panggil perintah [uninstall](https://docs.aws.amazon.com/cli/latest/reference/deploy/uninstall.html):

   ```
   aws deploy uninstall
   ```

## Untuk menghentikan instans Amazon EC2 secara manual (jika Anda meluncurkan instans Amazon EC2 secara manual)
<a name="tutorials-github-clean-up-ec2-instance"></a>

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon EC2 di. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)

1. Di panel navigasi, di **Instans**, pilih **Instans**.

1. Pilih kotak di sebelah instans Amazon EC2 yang ingin Anda hentikan. Di menu **Actions**, arahkan ke **Instance State**, lalu pilih **Terminate.**

1. Saat diminta, pilih **Ya, Hentikan**. 

## Untuk menghapus catatan komponen CodeDeploy penyebaran
<a name="tutorials-github-clean-up-codedeploy-records"></a>

1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**  
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).

1. **Di panel navigasi, perluas **Deploy**, lalu pilih Applications.**

   

1. Pilih **CodeDeployGitHubDemo-App**.

1. Pilih **Hapus aplikasi**.

1. Saat diminta, masukkan **Delete**, lalu pilih **Hapus**. 

## Untuk menghapus GitHub repositori Anda
<a name="tutorials-github-clean-up-github-repository"></a>

[Lihat [Menghapus repositori dalam](https://help.github.com/articles/deleting-a-repository/) bantuan. GitHub ](https://help.github.com)