Tutorial: Unggah artefak ke Amazon S3 - Amazon CodeCatalyst

View a markdown version of this page

Tutorial: Unggah artefak ke Amazon S3 - Amazon CodeCatalyst
PrasyaratLangkah 1: Buat AWS peranLangkah 2: Buat bucket Amazon S3Langkah 3: Buat repositori sumberLangkah 4: Buat alur kerjaLangkah 5: Verifikasi hasilnyaBersihkan

Amazon CodeCatalyst tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Lihat informasi yang lebih lengkap di Cara bermigrasi dari CodeCatalyst.

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

Tutorial: Unggah artefak ke Amazon S3

Dalam tutorial ini, Anda mempelajari cara mengunggah artefak ke bucket Amazon S3 menggunakan CodeCatalyst alur kerja Amazon yang mencakup beberapa tindakan pembuatan. Tindakan ini berjalan secara seri saat alur kerja dimulai. Tindakan build pertama menghasilkan dua file, Hello.txt danGoodbye.txt, dan menggabungkan mereka menjadi artefak build. Tindakan build kedua mengunggah artefak ke Amazon S3. Anda akan mengonfigurasi alur kerja untuk berjalan setiap kali Anda mendorong komit ke repositori sumber Anda.

Prasyarat

Sebelum memulai, Anda perlu melakukan hal berikut:

  • Anda membutuhkan CodeCatalyst ruang dengan AWS akun yang terhubung. Untuk informasi selengkapnya, lihat Membuat ruang.

  • Di ruang Anda, Anda memerlukan proyek kosong yang disebut:

    codecatalyst-artifact-project

    Gunakan opsi Mulai dari awal untuk membuat proyek ini.

    Untuk informasi selengkapnya, lihat Membuat proyek kosong di Amazon CodeCatalyst.

  • Dalam proyek Anda, Anda memerlukan CodeCatalyst lingkungan yang disebut:

    codecatalyst-artifact-environment

    Konfigurasikan lingkungan ini sebagai berikut:

    • Pilih jenis apa saja, seperti Peng embangan.

    • Hubungkan AWS akun Anda ke sana.

    • Untuk peran IAM Def ault, pilih peran apa saja. Anda akan menentukan peran yang berbeda nanti.

    Untuk informasi selengkapnya, lihat Menyebarkan ke Akun AWS dan VPC.

Langkah 1: Buat AWS peran

Pada langkah ini, Anda membuat peran AWS IAM yang nantinya akan Anda tetapkan ke tindakan build dalam alur kerja Anda. Peran ini memberikan izin tindakan CodeCatalyst build untuk mengakses AWS akun Anda dan menulis ke Amazon S3 tempat artefak Anda akan disimpan. Peran ini disebut peran Build.

catatan

Jika Anda sudah memiliki peran build yang Anda buat untuk tutorial lain, Anda dapat menggunakannya untuk tutorial ini juga. Pastikan saja memiliki izin dan kebijakan kepercayaan yang ditunjukkan dalam prosedur berikut.

Untuk informasi selengkapnya tentang peran IAM, lihat peran IAM di Panduan AWS AWS Identity and Access Management Pengguna.

Untuk membuat peran membangun

  1. Buat kebijakan untuk peran tersebut, sebagai berikut:

    1. Masuk ke AWS.

    2. Buka konsol IAM di https://console.aws.amazon.com/iam/.

    3. Di panel navigasi, pilih Kebijakan.

    4. Pilih Buat kebijakan.

    5. Pilih tab JSON.

    6. Hapus kode yang ada.

    7. Tempel kode berikut:

      JSON
      {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:ListBucket"
            ],
            "Resource": "*"
        }
    ]
}
      catatan

      Pertama kali peran digunakan untuk menjalankan tindakan alur kerja, gunakan wildcard dalam pernyataan kebijakan sumber daya dan kemudian lingkup kebijakan dengan nama sumber daya setelah tersedia.

      "Resource": "*"

    8. Pilih Berikutnya: Tanda.

    9. Pilih Berikutnya: Tinjau.

    10. Di Nama, masukkan:

      codecatalyst-s3-build-policy

    11. Pilih Buat kebijakan.

      Anda sekarang telah membuat kebijakan izin.

  2. Buat peran build, sebagai berikut:

    1. Di panel navigasi, pilih Peran, lalu pilih Buat peran.

    2. Pilih Kebijakan kepercayaan khusus.

    3. Hapus kebijakan kepercayaan kustom yang ada.

    4. Tambahkan kebijakan kepercayaan kustom berikut:

    5. Pilih Berikutnya.

    6. Di Kebijakan Izin, cari codecatalyst-s3-build-policy dan pilih kotak centangnya.

    7. Pilih Berikutnya.

    8. Untuk Nama Peran, masukkan:

      codecatalyst-s3-build-role

    9. Untuk Deskripsi Per an, masukkan:

      CodeCatalyst build role

    10. Pilih Buat peran.

    Anda sekarang telah membuat peran build dengan kebijakan kepercayaan dan kebijakan izin.

Langkah 2: Buat bucket Amazon S3

Pada langkah ini, Anda membuat bucket Amazon S3 tempat Goodbye.txt artefak Hello.txt dan akan diunggah.

Untuk membuat bucket Amazon S3

  1. Buka konsol Amazon S3 di https://console.aws.amazon.com/s3/.

  2. Di panel utama, pilih Buat bucket.

  3. Untuk nama Bucket, masukkan:

    codecatalyst-artifact-bucket

  4. Untuk Wilayah AWS , pilih Wilayah. Tutorial ini mengasumsikan Anda memilih US West (Oregon) us-west-2. Untuk informasi tentang Wilayah yang didukung oleh Amazon S3, lihat titik akhir dan kuota Layanan Penyimpanan Sederhana Amazon di Referensi Umum AWS.

  5. Di bagian bawah halaman, pilih Buat bucket.

  6. Salin nama bucket yang baru saja Anda buat, misalnya:

    codecatalyst-artifact-bucket

Anda sekarang telah membuat ember yang disebut codecatalyst-artifact-bucket di Wilayah Amerika Serikat Barat (Oregon) us-west-2.

Langkah 3: Buat repositori sumber

Pada langkah ini, Anda membuat repositori sumber di CodeCatalyst. Repositori ini digunakan untuk menyimpan file definisi alur kerja tutorial.

Untuk informasi selengkapnya tentang repositori sumber, lihatMembuat repositori sumber.

Untuk membuat repositori sumber

  1. Buka CodeCatalyst konsol di https://codecatalyst.aws/.

  2. Arahkan ke proyek Anda,codecatalyst-artifact-project.

  3. Di panel navigasi, pilih Kode, lalu pilih repositori Sumber.

  4. Pilih Tambahkan repositori, lalu pilih Buat repositori.

  5. Di Nama Repositori, masukkan:

    codecatalyst-artifact-source-repository

  6. Pilih Buat.

Anda sekarang telah membuat repositori yang disebutcodecatalyst-artifact-source-repository.

Langkah 4: Buat alur kerja

Pada langkah ini, Anda membuat alur kerja yang terdiri dari blok bangunan berikut yang berjalan secara berurutan:

  • Pemicu — Pemicu ini memulai alur kerja berjalan secara otomatis saat Anda mendorong perubahan ke repositori sumber Anda. Untuk informasi lebih lanjut tentang pemicu, lihatMemulai alur kerja berjalan secara otomatis menggunakan pemicu.

  • Tindakan build yang disebut GenerateFiles - Pada pemicu, GenerateFiles tindakan membuat dua file, Hello.txt danGoodbye.txt, dan mengemasnya ke dalam artefak keluaran yang disebutcodecatalystArtifact.

  • Tindakan build lain yang disebut Upload — Setelah GenerateFiles menyelesaikan tindakan, Upload tindakan menjalankan AWS CLI perintah aws s3 sync untuk mengunggah file di codecatalystArtifact dan di repositori sumber Anda ke bucket Amazon S3 Anda. Mun AWS CLI cul pra-instal dan pra-konfigurasi pada platform CodeCatalyst komputasi, jadi Anda tidak perlu menginstal atau mengkonfigurasinya.

    Untuk informasi selengkapnya tentang perangkat lunak pra-paket pada platform CodeCatalyst komputasi, lihat. Menentukan gambar lingkungan runtime Untuk informasi selengkapnya tentang AWS CLIaws s3 sync perintah, lihat sinkronisasi di Referensi AWS CLI Perintah.

Untuk informasi selengkapnya tentang tindakan build, lihatMembangun dengan alur kerja.

Untuk membuat alur kerja

  1. Di panel navigasi, pilih CI/CD, lalu pilih Alur kerja.

  2. Pilih Buat alur kerja.

  3. Hapus kode sampel YAML.

  4. Tambahkan kode YAML berikut:

    catatan

    Dalam kode YAML berikut, Anda dapat menghilangkan Connections: bagian jika Anda mau. Jika Anda menghilangkan bagian ini, Anda harus memastikan bahwa peran yang ditentukan di bidang Peran IAM default di lingkungan Anda mencakup izin dan kebijakan kepercayaan yang dijelaskan dalam. Langkah 1: Buat AWS peran Untuk informasi selengkapnya tentang menyiapkan lingkungan dengan peran IAM default, lihatPembuatan lingkungan.

    Name: codecatalyst-artifact-workflow
SchemaVersion: 1.0

Triggers:
  - Type: Push
    Branches:
      - main   
Actions:
  GenerateFiles:
    Identifier: aws/build@v1
    Configuration: 
      Steps:
        # Create the output files.
        - Run: echo "Hello, World!" > "Hello.txt"
        - Run: echo "Goodbye!" > "Goodbye.txt"
    Outputs:
      Artifacts:
        - Name: codecatalystArtifact
          Files:
            - "**/*"
  Upload:
    Identifier: aws/build@v1
    DependsOn: 
      - GenerateFiles
    Environment:
      Name: codecatalyst-artifact-environment
      Connections:
        - Name: codecatalyst-account-connection
          Role: codecatalyst-s3-build-role
    Inputs:
      Artifacts:
        - codecatalystArtifact
    Configuration: 
      Steps:
        # Upload the output artifact to the S3 bucket.
        - Run: aws s3 sync . s3://codecatalyst-artifact-bucket

    Dalam kode di atas, ganti:

    Untuk informasi tentang properti dalam file ini, lihatMembangun dan menguji tindakan YAML.

  5. (Opsional) Pilih Validasi untuk memastikan kode YAML valid sebelum melakukan.

  6. Pilih Terapkan.

  7. Pada kotak dialog Commit workflow, masukkan yang berikut ini:

    1. Untuk nama file Workflow, tinggalkan default,codecatalyst-artifact-workflow.

    2. Untuk pesan Commit, masukkan:

      add initial workflow file

    3. Untuk Repositori, pilih codec atalyst-artifact-source-repository.

    4. Untuk Nama cabang, pilih utama.

    5. Pilih Terapkan.

    Anda sekarang telah membuat alur kerja. Proses alur kerja dimulai secara otomatis karena pemicu yang ditentukan di bagian atas alur kerja. Secara khusus, ketika Anda melakukan komite (dan mendorong) codecatalyst-artifact-workflow.yaml file ke repositori sumber Anda, pemicu memulai alur kerja yang dijalankan.

Untuk melihat alur kerja yang sedang berjalan

  1. Di panel navigasi, pilih CI/CD, lalu pilih Alur kerja.

  2. Pilih alur kerja yang baru saja Anda buat:codecatalyst-artifact-workflow.

  3. Pilih GenerateFiles untuk melihat kemajuan aksi build pertama.

  4. Pilih Ung gah untuk melihat kemajuan tindakan build kedua.

  5. Saat tindakan Unggah selesai, lakukan hal berikut:

    • Jika alur kerja berjalan berhasil, lanjutkan ke prosedur berikutnya.

    • Jika alur kerja gagal, pilih Log untuk memecahkan masalah.

Langkah 5: Verifikasi hasilnya

Setelah alur kerja berjalan, buka layanan Amazon S3 dan lihat di codecatalyst-artifact-bucket bucket Anda. Sekarang harus mencakup file dan folder berikut:

.
|— .aws/
|— .git/
|Goodbye.txt
|Hello.txt
|REAME.md

Hello.txtFile Goodbye.txt dan diunggah karena merupakan bagian dari codecatalystArtifact artefak. File.aws/,.git/, dan README.md diunggah karena ada di repositori sumber Anda.

Bersihkan

Bersihkan CodeCatalyst dan AWS untuk menghindari dikenakan biaya untuk layanan ini.

Untuk membersihkan di CodeCatalyst

  1. Buka CodeCatalyst konsol di https://codecatalyst.aws/.

  2. Hapus repositori codecatalyst-artifact-source-repository sumber.

  3. Hapus al codecatalyst-artifact-workflow ur kerja.

Untuk membersihkan di AWS

  1. Bersihkan di Amazon S3, sebagai berikut:

    1. Buka konsol Amazon S3 di https://console.aws.amazon.com/s3/.

    2. Hapus file di codecatalyst-artifact-bucket bucket.

    3. Hapus codecatalyst-artifact-bucket bucket.

  2. Bersihkan di IAM, sebagai berikut:

    1. Buka konsol IAM di https://console.aws.amazon.com/iam/.

    2. Hapuscodecatalyst-s3-build-policy.

    3. Hapuscodecatalyst-s3-build-role.