

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

# Memulai dengan koneksi
<a name="getting-started-connections"></a>

Cara termudah untuk memulai koneksi adalah dengan mengatur koneksi yang mengaitkan repositori sumber pihak ketiga Anda ke sumber daya Anda. AWS Jika Anda ingin menghubungkan pipeline Anda ke AWS sumber, seperti CodeCommit, Anda akan menghubungkannya sebagai tindakan sumber. Namun, jika Anda memiliki repositori eksternal, Anda harus membuat koneksi untuk mengaitkan repositori Anda dengan alur Anda. Dalam tutorial ini, Anda mengatur koneksi dengan repositori Bitbucket dan alur Anda.

Di bagian ini, Anda menggunakan koneksi dengan: 
+ AWS CodePipeline: Dalam langkah-langkah ini, Anda membuat alur dengan repositori Bitbucket Anda sebagai sumber alur.
+ [Amazon CodeGuru Reviewer](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/welcome.html): Selanjutnya, Anda mengaitkan repositori Bitbucket Anda ke umpan balik dan alat analisis Anda di Reviewer. CodeGuru 

**Topics**
+ [Prasyarat](#getting-started-connections-prerequisites)
+ [Langkah 1: Edit file sumber Anda](#getting-started-connections-edit)
+ [Langkah 2: Buat alur Anda](#getting-started-connections-pipeline)
+ [Langkah 3: Kaitkan repositori Anda dengan Reviewer CodeGuru](#getting-started-connections-analysis)

## Prasyarat
<a name="getting-started-connections-prerequisites"></a>

Sebelum memulai, selesaikan langkah-langkah di [Pengaturan](setting-up.md). Anda juga memerlukan repositori sumber pihak ketiga yang ingin Anda sambungkan ke AWS layanan Anda dan memungkinkan koneksi untuk mengelola otentikasi untuk Anda. Misalnya, Anda mungkin ingin menghubungkan repositori Bitbucket ke AWS layanan Anda yang terintegrasi dengan repositori sumber.
+ Buat repositori Bitbucket dengan akun Bitbucket Anda.
+ Siapkan kredensial Bitbucket Anda. Ketika Anda menggunakan Konsol Manajemen AWS untuk mengatur koneksi, Anda diminta untuk masuk dengan kredenal Bitbucket Anda. 

## Langkah 1: Edit file sumber Anda
<a name="getting-started-connections-edit"></a>

Saat Anda membuat repositori Bitbucket, file `README.md` default disertakan, yang akan Anda edit.

1. Masuk ke repositori Bitbucket Anda dan pilih **Sumber**.

1. Pilih file `README.md` dan pilih **Edit** di bagian atas halaman. Hapus teks yang ada dan tambahkan teks berikut.

   ```
   This is a Bitbucket repository!
   ```

1. Pilih **Lakukan**.

   Pastikan file `README.md` berada di tingkat root repositori Anda..

## Langkah 2: Buat alur Anda
<a name="getting-started-connections-pipeline"></a>

Dalam bagian ini, Anda membuat alur dengan tindakan berikut:
+ Tahap sumber dengan koneksi ke repositori dan tindakan Bitbucket Anda.
+ Tahap build dengan aksi AWS CodeBuild build.

**Untuk membuat alur dengan wizard**

1. Masuk ke CodePipeline konsol di [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).

1. Pada halaman **Selamat Datang**, halaman **Memulai**, atau halaman **Alur**, pilih **Buat alur**.

1. Di **Langkah 1: Pilih pengaturan alur**, di **Nama alur**, masukkan **MyBitbucketPipeline**.

1. Di **Peran layanan**, pilih **Peran layanan baru**.
**catatan**  
Jika Anda memilih untuk menggunakan peran CodePipeline layanan yang ada, pastikan Anda telah menambahkan izin `codeconnections:UseConnection` IAM ke kebijakan peran layanan Anda. Untuk petunjuk tentang peran CodePipeline layanan, lihat [Menambahkan izin ke peran CodePipeline layanan](https://docs.aws.amazon.com/codepipeline/latest/userguide/security-iam.html#how-to-update-role-new-services).

1. Di bawah **Pengaturan lanjutan**, biarkan default. Di **Penyimpanan artifact**, pilih **Lokasi default** untuk menggunakan penyimpanan artifact default, seperti bucket artifact Amazon S3 yang ditetapkan sebagai default, untuk alur Anda di Wilayah yang Anda pilih untuk alur Anda.
**catatan**  
Ini bukan bucket sumber untuk kode sumber Anda. Ini adalah penyimpanan artifact untuk alur Anda. Penyimpanan artifact terpisah, seperti bucket S3, diperlukan untuk setiap alur.

   Pilih **Selanjutnya**.

1. Pada halaman **Langkah 2: Tambahkan tahap sumber**, tambahkan tahap sumber:

   1. Di **Penyedia sumber**, pilih **Bitbucket**.

   1. Pada **Koneksi**, pilih **Hubungkan ke Bitbucket**.

   1. Pada halaman **Hubungkan ke Bitbucket**, di **Nama koneksi**, masukkan nama untuk koneksi yang ingin Anda buat. Nama membantu Anda mengidentifikasi koneksi ini nanti.

      Pada **Aplikasi Bitbucket**, pilih **Instal aplikasi baru**.

   1. Pada halaman instalasi aplikasi, sebuah pesan menunjukkan bahwa AWS CodeStar aplikasi sedang mencoba untuk terhubung ke akun Bitbucket Anda. Pilih **Berikan akses**. Setelah Anda mengotorisasi koneksi, repositori Anda di Bitbucket terdeteksi, dan Anda dapat memilih untuk mengaitkannya dengan sumber daya Anda. AWS 

   1. ID koneksi untuk instalasi baru Anda ditampilkan. Pilih **Selesaikan koneksi**. Anda akan dikembalikan ke CodePipeline konsol.

   1. Di **Nama repositori**, pilih nama repositori Bitbucket Anda.

   1. Dalam **nama Branch**, pilih cabang untuk repositori Anda.

   1. Pastikan opsi **Mulai pipeline pada perubahan kode sumber** dipilih.

   1. Di bawah **Format artefak keluaran**, pilih salah satu dari berikut ini: **CodePipeline default**.
      + Pilih **CodePipeline default** untuk menggunakan format zip default untuk artefak di pipeline.
      + Pilih **klon lengkap** untuk menyertakan metadata Git tentang repositori artefak dalam pipeline. Ini hanya didukung untuk CodeBuild tindakan.

   Pilih **Berikutnya**.

1. Di **Tambahkan tahap membangun**, tambahkan sebuah tahap membangun:

   1. Di **Penyedia pembangunan**, pilih **AWS CodeBuild**. Izinkan **Wilayah** ke default ke Wilayah alur.

   1. Pilih **Buat proyek**.

   1. Di **Nama proyek**, masukkan nama untuk proyek pembangunan ini.

   1. Di **Citra lingkungan**, pilih **Citra terkelola**. Untuk **Sistem operasi**, pilih **Ubuntu**.

   1. Untuk **Waktu aktif**, pilih **Standar**. **Untuk **Gambar**, pilih:5.0aws/codebuild/standard.**

   1. Untuk **Peran layanan**, pilih **Peran layanan baru**.

   1. Pada **Buildspec**, untuk **Spesifikasi membangun**, pilih **Sisipkan perintah membangun**. Pilih **Beralih ke editor**, dan tempel berikut ini di **Perintah membangun**:

      ```
      version: 0.2
      
      phases:
        install:
          #If you use the Ubuntu standard image 2.0 or later, you must specify runtime-versions.
          #If you specify runtime-versions and use an image other than Ubuntu standard image 2.0, the build fails.
          runtime-versions:
            nodejs: 12
            # name: version
          #commands:
            # - command
            # - command
        pre_build:
          commands:
            - ls -lt
            - cat README.md
        # build:
          #commands:
            # - command
            # - command
        #post_build:
          #commands:
            # - command
            # - command
      #artifacts:
        #files:
          # - location
          # - location
        #name: $(date +%Y-%m-%d)
        #discard-paths: yes
        #base-directory: location
      #cache:
        #paths:
          # - paths
      ```

   1. Pilih **Lanjutkan ke CodePipeline**. Ini kembali ke CodePipeline konsol dan membuat CodeBuild proyek yang menggunakan perintah build Anda untuk konfigurasi. Proyek build menggunakan peran layanan untuk mengelola izin AWS layanan. Langkah ini mungkin memakan waktu beberapa menit.

   1. Pilih **Selanjutnya**.

1. Pada halaman **Langkah 4: Tambahkan tahap men-deploy**, pilih **Lewati tahap men-deploy**, dan kemudian terima pesan peringatan dengan memilih **Lewati** lagi. Pilih **Selanjutnya**.

1. Pada **Langkah 5: Tinjauan**, pilih **Buat alur**.

1. Ketika alur Anda berhasil dibuat, eksekusi alur dimulai.  
![Tangkapan layar konsol yang menampilkan alur yang berhasil diselesaikan dengan sumber Bitbucket.](http://docs.aws.amazon.com/id_id/dtconsole/latest/userguide/images/pipeline-wizard-bitbucket.png)

1. Pada tahap membangun Anda yang berhasil, pilih **Detail**.

   Di bawah **Detail eksekusi**, lihat keluaran CodeBuild build. Perintah mengeluarkan isi file `README.md` sebagai berikut:

   ```
   This is a Bitbucket repository!
   ```  
![Tangkapan layar konsol yang menampilkan contoh keluaran pembangunan yang berhasil diselesaikan.](http://docs.aws.amazon.com/id_id/dtconsole/latest/userguide/images/pipeline-wizard-bitbucket-output.png)

## Langkah 3: Kaitkan repositori Anda dengan Reviewer CodeGuru
<a name="getting-started-connections-analysis"></a>

Setelah Anda membuat koneksi, Anda dapat menggunakan koneksi itu untuk semua sumber AWS daya Anda di akun yang sama. Misalnya, Anda dapat menggunakan koneksi Bitbucket yang sama untuk tindakan CodePipeline sumber dalam pipeline dan analisis komit repositori Anda di Reviewer. CodeGuru 

1. Masuk ke konsol CodeGuru Reviewer.

1. Di bawah **CodeGuru Reviewer**, pilih **Repositori asosiasi**.

   Wizard satu halaman terbuka.

1. Pada **Pilih penyedia sumber**, pilih **Bitbucket**.

1. Di bawah **Connect to Bitbucket (with AWS CodeConnections)**, pilih koneksi yang Anda buat untuk pipeline.

1. Pada **Lokasi repositori**, pilih nama repositori Bitbucket Anda, lalu pilih **Kaitkan**.

   Anda dapat melanjutkan untuk mengatur tinjauan kode. Untuk informasi selengkapnya, lihat [Menghubungkan ke Bitbucket untuk mengaitkan repositori dengan CodeGuru Reviewer di Panduan Pengguna](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/create-bitbucket-association.html) *Amazon CodeGuru * Reviewer.