Konfigurasikan Swift Package Manager dengan CodeArtifact - CodeArtifact
Konfigurasikan Swift dengan perintah loginKonfigurasikan Swift tanpa perintah login

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

Konfigurasikan Swift Package Manager dengan CodeArtifact

Untuk menggunakan Swift Package Manager untuk memublikasikan paket ke atau menggunakan paket dari AWS CodeArtifact, Anda harus terlebih dahulu menyiapkan kredensil untuk mengakses repositori Anda. CodeArtifact Metode yang disarankan untuk mengonfigurasi CLI Swift Package Manager dengan CodeArtifact kredensi dan titik akhir repositori Anda adalah dengan menggunakan perintah. aws codeartifact login Anda juga dapat mengkonfigurasi Swift Package Manager secara manual.

Konfigurasikan Swift dengan perintah login

Gunakan aws codeartifact login perintah untuk mengkonfigurasi Swift Package Manager dengan CodeArtifact.

catatan

Untuk menggunakan perintah login, Swift 5.8 atau yang lebih baru diperlukan dan Swift 5.9 atau yang lebih baru direkomendasikan.

aws codeartifact loginPerintah akan melakukan hal berikut:

  1. Ambil token otentikasi dari CodeArtifact dan simpan di lingkungan Anda. Bagaimana kredensil disimpan tergantung pada sistem operasi lingkungan:

    1. macOS: Entri dibuat di aplikasi macOS Keychain.

    2. Linux dan Windows: Entri dibuat dalam ~/.netrc file.

    Di semua sistem operasi, jika ada entri kredensil, perintah ini menggantikan entri itu dengan token baru.

  2. Ambil URL endpoint CodeArtifact repositori Anda dan tambahkan ke file konfigurasi Swift Anda. Perintah menambahkan URL titik akhir repositori ke file konfigurasi tingkat proyek yang terletak di. /path/to/project/.swiftpm/configuration/registries.json

catatan

aws codeartifact loginPerintah memanggil swift package-registry perintah yang harus dijalankan dari direktori yang berisi Package.swift file. Karena itu, aws codeartifact login perintah harus dijalankan dari dalam proyek Swift.

Untuk mengkonfigurasi Swift dengan perintah login

  1. Arahkan ke direktori proyek Swift yang berisi Package.swift file proyek Anda.

  2. Jalankan perintah aws codeartifact login berikut.

    Jika Anda mengakses repositori di domain milik Anda, Anda tidak perlu menyertakan --domain-owner. Untuk informasi selengkapnya, lihat Domain lintas akun.

    aws codeartifact login --tool swift --domain my_domain \
--domain-owner 111122223333 --repository my_repo \
[--namespace my_namespace]

--namespaceOpsi mengonfigurasi aplikasi untuk hanya menggunakan paket dari CodeArtifact repositori Anda jika mereka berada di namespace yang ditentukan. CodeArtifact namespace identik dengan cakupan, dan digunakan untuk mengatur kode ke dalam grup logis dan untuk mencegah tabrakan nama yang dapat terjadi ketika basis kode Anda menyertakan beberapa pustaka.

Periode otorisasi default setelah memanggil login adalah 12 jam, dan login harus dipanggil untuk menyegarkan token secara berkala. Untuk informasi selengkapnya tentang token otorisasi yang dibuat dengan perintah login, lihat Token dibuat dengan perintah login.

Konfigurasikan Swift tanpa perintah login

Meskipun disarankan agar Anda mengkonfigurasi Swift dengan aws codeartifact login perintah, Anda juga dapat mengkonfigurasi Swift Package Manager tanpa perintah login dengan memperbarui konfigurasi Swift Package Manager secara manual.

Dalam prosedur berikut, Anda akan menggunakan AWS CLI untuk melakukan hal berikut:

  1. Ambil token otentikasi dari CodeArtifact dan simpan di lingkungan Anda. Bagaimana kredensil disimpan tergantung pada sistem operasi lingkungan:

    1. macOS: Entri dibuat di aplikasi macOS Keychain.

    2. Linux dan Windows: Entri dibuat dalam ~/.netrc file.

  2. Ambil URL titik akhir CodeArtifact repositori Anda.

  3. Dalam file ~/.swiftpm/configuration/registries.json konfigurasi, tambahkan entri dengan URL titik akhir repositori dan jenis otentikasi Anda.

Untuk mengkonfigurasi Swift tanpa perintah login

  1. Dalam baris perintah, gunakan perintah berikut untuk mengambil token CodeArtifact otorisasi dan menyimpannya dalam variabel lingkungan.

    • Ganti my_domain dengan nama CodeArtifact domain Anda.

    • Ganti 111122223333 dengan ID AWS akun pemilik domain. Jika Anda mengakses repositori di domain milik Anda, Anda tidak perlu menyertakan --domain-owner. Untuk informasi selengkapnya, lihat Domain lintas akun.

    macOS and Linux
    export CODEARTIFACT_AUTH_TOKEN=`aws codeartifact get-authorization-token --domain my_domain --domain-owner 111122223333 --query authorizationToken --output text`
    Windows

    • Windows (menggunakan shell perintah default):

      for /f %i in ('aws codeartifact get-authorization-token --domain my_domain --domain-owner 111122223333 --query authorizationToken --output text') do set CODEARTIFACT_AUTH_TOKEN=%i

    • Jendela PowerShell:

      $env:CODEARTIFACT_AUTH_TOKEN = aws codeartifact get-authorization-token --domain my_domain --domain-owner 111122223333 --query authorizationToken --output text

  2. Dapatkan endpoint CodeArtifact repositori Anda dengan menjalankan perintah berikut. Endpoint repositori Anda digunakan untuk mengarahkan Swift Package Manager ke repositori Anda untuk mengkonsumsi atau menerbitkan paket.

    • Ganti my_domain dengan nama CodeArtifact domain Anda.

    • Ganti 111122223333 dengan ID AWS akun pemilik domain. Jika Anda mengakses repositori di domain milik Anda, Anda tidak perlu menyertakan --domain-owner. Untuk informasi selengkapnya, lihat Domain lintas akun.

    • Ganti my_repo dengan nama CodeArtifact repositori Anda.

    macOS and Linux
    export CODEARTIFACT_REPO=`aws codeartifact get-repository-endpoint --domain my_domain --domain-owner 111122223333 --repository my_repo --format swift --query repositoryEndpoint --output text`
    Windows

    • Windows (menggunakan shell perintah default):

      for /f %i in ('aws codeartifact get-repository-endpoint --domain my_domain --domain-owner 111122223333 --repository my_repo --format swift --query repositoryEndpoint --output text') do set CODEARTIFACT_REPO=%i

    • Jendela PowerShell:

      $env:CODEARTIFACT_REPO = aws codeartifact get-repository-endpoint --domain my_domain --domain-owner 111122223333 --repository my_repo --format swift --query repositoryEndpoint --output text

    URL berikut adalah contoh titik akhir repositori.

    https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/swift/my_repo/
    catatan

    Untuk menggunakan endpoint dualstack, gunakan endpoint. codeartifact.region.on.aws

    penting

    Anda harus menambahkan login ke akhir endpoint URL repositori saat digunakan untuk mengkonfigurasi Swift Package Manager. Ini dilakukan untuk Anda dalam perintah prosedur ini.

  3. Dengan dua nilai ini disimpan dalam variabel lingkungan, teruskan ke Swift menggunakan swift package-registry login perintah sebagai berikut:

    macOS and Linux
    swift package-registry login ${CODEARTIFACT_REPO}login --token ${CODEARTIFACT_AUTH_TOKEN}
    Windows

    • Windows (menggunakan shell perintah default):

      swift package-registry login %CODEARTIFACT_REPO%login --token %CODEARTIFACT_AUTH_TOKEN%

    • Jendela PowerShell:

      swift package-registry login $Env:CODEARTIFACT_REPO+"login" --token $Env:CODEARTIFACT_AUTH_TOKEN

  4. Selanjutnya, perbarui registri paket yang digunakan oleh aplikasi Anda sehingga ketergantungan apa pun akan ditarik dari CodeArtifact repositori Anda. Perintah ini harus dijalankan di direktori proyek tempat Anda mencoba menyelesaikan ketergantungan paket:

    macOS and Linux
    $ swift package-registry set ${CODEARTIFACT_REPO} [--scope my_scope]
    Windows

    • Windows (menggunakan shell perintah default):

      $ swift package-registry set %CODEARTIFACT_REPO% [--scope my_scope]

    • Jendela PowerShell:

      $ swift package-registry set $Env:CODEARTIFACT_REPO [--scope my_scope]

    --scopeOpsi mengonfigurasi aplikasi untuk hanya menggunakan paket dari CodeArtifact repositori Anda jika mereka berada dalam lingkup yang ditentukan. Cakupan identik dengan CodeArtifact ruang nama, dan digunakan untuk mengatur kode ke dalam grup logis dan untuk mencegah tabrakan nama yang dapat terjadi ketika basis kode Anda menyertakan beberapa pustaka.

  5. Anda dapat mengonfirmasi bahwa konfigurasi telah diatur dengan benar dengan melihat isi .swiftpm/configuration/registries.json file tingkat proyek dengan menjalankan perintah berikut di direktori proyek Anda:

    $ cat .swiftpm/configuration/registries.json
{
  "authentication" : {

  },
  "registries" : {
    "[default]" : {
      "url" : "https://my-domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/swift/my-repo/"
    }
  },
  "version" : 1
}

Sekarang setelah Anda mengkonfigurasi Swift Package Manager dengan CodeArtifact repositori Anda, Anda dapat menggunakannya untuk mempublikasikan dan menggunakan paket Swift ke dan dari itu. Untuk informasi selengkapnya, lihat Mengkonsumsi dan menerbitkan paket Swift.