View a markdown version of this page

Tutorial: Penandatanganan kode Apple dengan Fastlane dalam CodeBuild menggunakan S3 untuk penyimpanan sertifikat - AWS CodeBuild
PrasyaratLangkah 1: Siapkan Fastlane Match dengan S3 di mesin lokal AndaLangkah 2: Siapkan Fastfile AndaLangkah 3: Jalankan perintah fastlane match untuk menghasilkan sertifikat dan profil masing-masingLangkah 4: Buat file aplikasi untuk proyek AndaLangkah 5: Buat variabel lingkungan di Manajer RahasiaLangkah 6: Buat armada komputasiLangkah 7: Buat proyek di CodeBuildLangkah 8: Konfigurasikan peran IAMLangkah 9: Jalankan buildPemecahan masalahPertimbangan keamanan

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

Tutorial: Penandatanganan kode Apple dengan Fastlane dalam CodeBuild menggunakan S3 untuk penyimpanan sertifikat

fastlane adalah alat otomatisasi sumber terbuka yang populer untuk mengotomatiskan penerapan dan rilis beta untuk aplikasi iOS dan Android Anda. Ini menangani semua tugas yang membosankan, seperti membuat tangkapan layar, menangani penandatanganan kode, dan merilis aplikasi Anda.

Prasyarat

Untuk menyelesaikan tutorial ini, Anda harus terlebih dahulu menyiapkan yang berikut:

  • Sebuah Akun AWS

  • Akun Pengembang Apple

  • Bucket S3 untuk menyimpan sertifikat

  • fastlane diinstal di proyek Anda - Panduan untuk menginstal fastlane

Langkah 1: Siapkan Fastlane Match dengan S3 di mesin lokal Anda

Fastlane Match adalah salah satu alat Fastlane, dan memungkinkan konfigurasi yang mulus untuk penandatanganan kode di lingkungan pengembangan lokal Anda dan seterusnya. CodeBuild Fastlane Match menyimpan semua sertifikat penandatanganan kode dan profil penyediaan Anda di Git repository/S3 Bucket/Google Cloud Storage, dan mengunduh serta menginstal sertifikat dan profil yang diperlukan bila diperlukan.

Dalam contoh konfigurasi ini, Anda akan menyiapkan dan menggunakan bucket Amazon S3 untuk penyimpanan.

  1. Inisialisasi kecocokan dalam proyek Anda:

    fastlane match init

  2. Saat diminta, pilih S3 sebagai mode penyimpanan.

  3. Perbarui `Matchfile` Anda untuk menggunakan S3:

    storage_mode("s3")
   s3_bucket("your-s3-bucket-name")
   s3_region("your-aws-region")
   type("appstore") # The default type, can be: appstore, adhoc, enterprise or development

Langkah 2: Siapkan Fastfile Anda

Buat atau perbarui `Fastfile` Anda dengan jalur berikut.

Pada CodeBuild, Fastlane Match harus dijalankan setiap kali Anda membuat dan menandatangani aplikasi Anda. Cara termudah untuk melakukannya adalah dengan menambahkan match tindakan ke jalur yang membangun aplikasi Anda.

default_platform(:ios)

platform :ios do
  before_all do
    setup_ci
  end
  
  desc "Build and sign the app"
  lane :build do
    match(type: "appstore", readonly: true)
    gym(
      scheme: "YourScheme",
      export_method: "app-store"
    )
  end
end
catatan

Pastikan untuk menambahkan setup_ci ke before_all bagian Fastfile agar tindakan pertandingan berfungsi dengan benar. Ini memastikan bahwa gantungan kunci Fastlane sementara dengan izin yang sesuai digunakan. Tanpa menggunakan ini, Anda mungkin melihat kegagalan build atau hasil yang tidak konsisten.

Langkah 3: Jalankan perintah fastlane match untuk menghasilkan sertifikat dan profil masing-masing

Perintah fastlane match untuk tipe yang diberikan (yaitu, development, appstore, adhoc, enterprise) akan menghasilkan sertifikat dan profil jika tidak tersedia di remote store. Sertifikat dan profil akan disimpan di S3 oleh fastlane.

bundle exec fastlane match appstore

Eksekusi perintah akan interaktif dan fastlane akan meminta untuk mengatur frase sandi untuk mendekripsi sertifikat.

Langkah 4: Buat file aplikasi untuk proyek Anda

Buat atau tambahkan file aplikasi yang sesuai untuk proyek Anda.

  1. Buat atau tambahkan Gymfile, Appfile, Snapfile , Deliverfile berdasarkan persyaratan pembuatan proyek Anda.

  2. Lakukan perubahan ke repositori jarak jauh Anda

Langkah 5: Buat variabel lingkungan di Manajer Rahasia

Buat dua rahasia untuk menyimpan cookie sesi fastlane dan frase sandi yang cocok. Untuk informasi selengkapnya tentang membuat rahasia di Manajer Rahasia, lihat Membuat AWS Secrets Manager rahasia.

  1. Akses cookie sesi fastlane Anda sebagai berikut.

    1. Kunci rahasia - FASTLANE_SESSION

    2. Nilai rahasia - cookie sesi yang dihasilkan dari menjalankan perintah berikut pada mesin lokal Anda.

      catatan

      Nilai ini tersedia setelah otentikasi dalam file lokal:~/.fastlane/spaceship/my_appleid_username/cookie.

      fastlane spaceauth -u <apple account>

  2. Frasa sandi Fastlane Match - Untuk mengaktifkan Fastlane Match untuk mendekripsi sertifikat dan profil yang disimpan di bucket S3, Anda perlu menambahkan frasa sandi enkripsi yang Anda konfigurasikan pada langkah pengaturan Cocokkan ke variabel lingkungan proyek. CodeBuild

    1. Kunci rahasia - MATCH_PASSWORD

    2. Nilai rahasia -<match passphrase to decrypt certificates>. Frasa sandi disetel saat membuat sertifikat di Langkah 3.

catatan

Saat membuat rahasia di atas di Secrets Manager, ingatlah untuk memberikan nama rahasia dengan awalan berikut: /CodeBuild/

Langkah 6: Buat armada komputasi

Buat armada komputasi untuk proyek Anda.

  1. Di konsol, buka CodeBuild dan buat armada komputasi baru.

  2. Pilih “macOS” sebagai sistem operasi dan pilih jenis komputasi dan gambar yang sesuai.

Langkah 7: Buat proyek di CodeBuild

Buat proyek Anda di CodeBuild.

  1. Buka AWS CodeBuild konsol di https://console.aws.amazon.com/codesuite/codebuild/home.

  2. Buat proyek pembangunan. Untuk informasi selengkapnya, lihat Membuat proyek build (konsol) dan Jalankan build (konsol).

  3. Siapkan penyedia sumber Anda (seperti GitHub, CodeCommit). Ini adalah repositori sumber proyek iOS dan bukan repositori sertifikat.

  4. Di Lingkungan:

    • Pilih Kapas itas Cadangan.

    • Untuk Ar mada, pilih armada yang dibuat di atas.

    • Berikan nama peran layanan yang CodeBuild akan dibuat untuk Anda.

    • Berikan variabel lingkungan di bawah ini.

      • Nama:MATCH_PASSWORD, Nilai:<secrets arn>, Jenis: Manajer Rahasia (Rahasia ARN dibuat pada langkah 5 untuk MATCH_PASSWORD)

      • Nama:FASTLANE_SESSION, Nilai:<secrets arn>, Jenis: Manajer Rahasia (Rahasia ARN dibuat di Langkah 5 untuk FASTLANE_SESSION)

  5. Di Buildspec, tambahkan yang berikut ini:

    version: 0.2

phases:
  install:
    commands:
      - gem install bundler
      - bundle install
  build:
    commands:
      - echo "Building and signing the app..."
      - bundle exec fastlane build
  post_build:
    commands:
      - echo "Build completed on date"

artifacts:
  files:
    - '*/.ipa'
  name: app-$(date +%Y-%m-%d)

Langkah 8: Konfigurasikan peran IAM

Setelah proyek dibuat, pastikan peran layanan CodeBuild proyek Anda memiliki izin untuk mengakses bucket S3 yang berisi sertifikat. Tambahkan kebijakan berikut ke peran:

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetBucketLocation",
                "s3:ListBucket"
            ],
            "Resource": "arn:aws:s3:::your-s3-bucket-name"
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetObject",
                "s3:PutObject",
                "s3:DeleteObject"
            ],
            "Resource": "arn:aws:s3:::your-s3-bucket-name/*"
        }
    ]
}

Langkah 9: Jalankan build

Jalankan buildnya. Anda dapat meninjau status build dan log in CodeBuild.

Setelah pekerjaan selesai, Anda akan dapat melihat log pekerjaan.

Pemecahan masalah

  • Jika Anda mengalami masalah dengan pengambilan sertifikat, pastikan izin IAM diatur dengan benar untuk akses S3.

  • Jika Anda mengalami masalah dengan dekripsi sertifikat, pastikan Anda menetapkan frasa sandi yang benar di variabel lingkungan MATCH_PASSWORD.

  • Untuk masalah penandatanganan kode, verifikasi bahwa akun Pengembang Apple Anda memiliki sertifikat dan profil yang diperlukan, dan bahwa pengenal bundel di proyek Xcode Anda cocok dengan yang ada di profil penyediaan Anda.

Pertimbangan keamanan

Berikut ini adalah pertimbangan keamanan untuk tutorial ini.

  • Pastikan bucket S3 Anda memiliki pengaturan keamanan yang sesuai, termasuk enkripsi saat diam. Secara khusus, pastikan bucket tidak memiliki akses publik dan membatasi akses ke hanya CodeBuild dan sistem yang perlu memiliki akses.

  • Pertimbangkan AWS Secrets Manager untuk menggunakan untuk menyimpan informasi sensitif seperti MATCH_PASSWORD dan FASTLANE_SESSION.

Contoh ini menyediakan pengaturan untuk penandatanganan kode iOS dengan Fastlane dalam CodeBuild menggunakan Amazon S3 untuk penyimpanan sertifikat. Anda mungkin perlu menyesuaikan beberapa langkah berdasarkan persyaratan dan CodeBuild lingkungan proyek spesifik Anda. Pendekatan ini memanfaatkan AWS layanan untuk meningkatkan keamanan dan integrasi dalam AWS ekosistem.