Configura e usa RubyGems e Bundler con CodeArtifact - CodeArtifact
Configura RubyGems (gem) e Bundler () con bundle CodeArtifactInstallazione di Ruby gemsPubblicazione di gemme di Ruby

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configura e usa RubyGems e Bundler con CodeArtifact

Dopo aver creato un repository in CodeArtifact, puoi usare RubyGems (gem) e Bundler (bundle) per installare e pubblicare gemme. Questo argomento descrive come configurare i gestori di pacchetti per l'autenticazione e l'utilizzo di un repository. CodeArtifact

Configura RubyGems (gem) e Bundler () con bundle CodeArtifact

Per utilizzare RubyGems (gem) o Bundler (bundle) per pubblicare gemme o da cui consumare gemme AWS CodeArtifact, devi prima configurarli con le informazioni del tuo CodeArtifact repository, comprese le credenziali per accedervi. Segui i passaggi di una delle seguenti procedure per configurare gli strumenti e la bundle CLI con le informazioni gem e le credenziali dell'endpoint CodeArtifact del repository.

Configura RubyGems e raggruppa utilizzando le istruzioni della console

Puoi usare le istruzioni di configurazione nella console per connettere i tuoi gestori di pacchetti Ruby al tuo CodeArtifact repository. Le istruzioni della console forniscono comandi personalizzati che è possibile eseguire per configurare i gestori di pacchetti senza dover trovare e inserire le informazioni. CodeArtifact

  1. Apri la AWS CodeArtifact console all'indirizzo https://console.aws.amazon.com/codesuite/codeartifact/home.

  2. Nel pannello di navigazione, scegli Repository, quindi scegli il repository che desideri utilizzare per installare o inviare le gemme Ruby.

  3. Scegli Visualizza le istruzioni di connessione.

  4. Scegli il tuo sistema operativo.

  5. Scegli il client di gestione pacchetti Ruby che desideri configurare con il tuo CodeArtifact repository.

  6. Segui le istruzioni generate per configurare il client di gestione dei pacchetti da cui installare o pubblicare le gemme di Ruby nel repository.

Configura e raggruppa manualmente RubyGems

Se non puoi o non vuoi usare le istruzioni di configurazione della console, puoi usare le seguenti istruzioni per connetterti manualmente ai tuoi gestori di pacchetti Ruby al tuo CodeArtifact repository.

  1. In una riga di comando, usa il seguente comando per recuperare un token di CodeArtifact autorizzazione e memorizzarlo in una variabile di ambiente.

    • my_domainSostituiscilo con il tuo nome di CodeArtifact dominio.

    • Sostituiscilo 111122223333 con l'ID dell' AWS account del proprietario del dominio. Se accedi a un repository in un dominio di tua proprietà, non è necessario --domain-owner includerlo. Per ulteriori informazioni, consulta Domini con più account.

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

    • Windows (utilizzando la shell dei comandi predefinita):

      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

    • Windows PowerShell:

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

  2. Per pubblicare le gemme di Ruby nel tuo repository, usa il seguente comando per recuperare l'endpoint del tuo CodeArtifact repository e memorizzarlo nella variabile di ambiente. RUBYGEMS_HOST La gem CLI utilizza questa variabile di ambiente per determinare dove vengono pubblicate le gemme.

    Nota

    In alternativa, invece di utilizzare la variabile di RUBYGEMS_HOST ambiente, è possibile fornire all'endpoint del repository l'--hostopzione quando si utilizza il comando. gem push

    • Sostituiscilo my_domain con il tuo CodeArtifact nome di dominio.

    • Sostituiscilo 111122223333 con l'ID dell' AWS account del proprietario del dominio. Se accedi a un repository in un dominio di tua proprietà, non è necessario --domain-owner includerlo. Per ulteriori informazioni, consulta Domini con più account.

    • my_repoSostituiscilo con il nome del tuo CodeArtifact repository.

    macOS and Linux
    export RUBYGEMS_HOST=`aws codeartifact get-repository-endpoint --domain my_domain --domain-owner 111122223333 --repository my_repo --format ruby --query repositoryEndpoint --output text | sed 's:/*$::'`
    Windows

    I seguenti comandi recuperano l'endpoint del repository, tagliano il finale e lo memorizzano in una / variabile di ambiente.

    • Windows (utilizzando la shell dei comandi predefinita):

      for /f %i in ('aws codeartifact get-repository-endpoint --domain my_domain --domain-owner 111122223333 --repository my_repo --format ruby --query repositoryEndpoint --output text') do set RUBYGEMS_HOST=%i
                                
set RUBYGEMS_HOST=%RUBYGEMS_HOST:~0,-1%

    • Windows PowerShell:

      $env:RUBYGEMS_HOST = (aws codeartifact get-repository-endpoint --domain my_domain --domain-owner 111122223333 --repository my_repo --format ruby --query repositoryEndpoint --output text).TrimEnd("/")

    L'URL seguente è un esempio di endpoint del repository:

    https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/ruby/my_repo/
    Nota

    Per utilizzare un endpoint dualstack, usa l'endpoint. codeartifact.region.on.aws

  3. Per pubblicare le gemme di Ruby nel tuo repository, devi autenticarti su CodeArtifact with RubyGems modificando il file per includere il tuo token di autenticazione. ~/.gem/credentials Crea una ~/.gem/ directory e un ~/.gem/credentials file se la directory o il file non esiste.

    macOS and Linux
    echo ":codeartifact_api_key: Bearer $CODEARTIFACT_AUTH_TOKEN" >> ~/.gem/credentials
    Windows

    • Windows (utilizzando la shell di comando predefinita):

      echo :codeartifact_api_key: Bearer %CODEARTIFACT_AUTH_TOKEN% >> %USERPROFILE%/.gem/credentials

    • Windows PowerShell:

      echo ":codeartifact_api_key: Bearer $env:CODEARTIFACT_AUTH_TOKEN" | Add-Content ~/.gem/credentials

  4. gemPer installare le gemme Ruby dal tuo repository, devi aggiungere le informazioni sull'endpoint del repository e il token di autenticazione al tuo file. .gemrc Puoi aggiungerlo al file globale () ~/.gemrc o al file di progetto. .gemrc Le CodeArtifact informazioni da aggiungere a sono una combinazione dell'.gemrcendpoint del repository e del token di autenticazione. È formattata come segue:

    https://aws:${CODEARTIFACT_AUTH_TOKEN}@my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/ruby/my_repo/

    • Per il token di autenticazione, è possibile utilizzare la variabile di CODEARTIFACT_AUTH_TOKEN ambiente impostata in un passaggio precedente.

    • Per recuperare l'endpoint del repository, puoi leggere il valore della variabile di RUBYGEMS_HOST ambiente impostata in precedenza oppure puoi usare il seguente get-repository-endpoint comando, sostituendo i valori se necessario:

      aws codeartifact get-repository-endpoint --domain my_domain --domain-owner 111122223333 --repository my_repo --format ruby --query repositoryEndpoint --output text

    Dopo aver ottenuto l'endpoint, utilizzate un editor di testo per aggiungerlo aws:${CODEARTIFACT_AUTH_TOKEN}@ nella posizione appropriata. Una volta creati l'endpoint del repository e la stringa del token di autenticazione, aggiungili alla :sources: sezione del .gemrc file con il echo comando seguente:

    avvertimento

    CodeArtifact non supporta l'aggiunta di repository come sorgenti utilizzando il comando. gem sources -add È necessario aggiungere la fonte direttamente al file.

    macOS and Linux
    echo ":sources:
    - https://aws:${CODEARTIFACT_AUTH_TOKEN}@my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/ruby/my_repo/" > ~/.gemrc
    Windows

    • Windows (utilizzando la shell dei comandi predefinita):

      echo ":sources:
    - https://aws:%CODEARTIFACT_AUTH_TOKEN%@my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/ruby/my_repo/" > "%USERPROFILE%\.gemrc"

    • Windows PowerShell:

      echo ":sources:
    - https://aws:$env:CODEARTIFACT_AUTH_TOKEN@my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/ruby/my_repo/" | Add-Content ~/.gemrc

  5. Per utilizzare Bundler, devi configurare Bundler con l'URL dell'endpoint del repository e il token di autenticazione eseguendo il seguente comando: bundle config

    macOS and Linux
    bundle config $RUBYGEMS_HOST aws:$CODEARTIFACT_AUTH_TOKEN
    Windows

    • Windows (utilizzando la shell dei comandi predefinita):

      bundle config %RUBYGEMS_HOST% aws:%CODEARTIFACT_AUTH_TOKEN%

    • Windows PowerShell:

      bundle config $Env:RUBYGEMS_HOST aws:$Env:CODEARTIFACT_AUTH_TOKEN

Ora che hai configurato RubyGems (gem) e Bundler (bundle) con il tuo CodeArtifact repository, puoi usarli per pubblicare e utilizzare le gemme di Ruby da e verso di esso.

Installazione di Ruby gems da CodeArtifact

Usa le seguenti procedure per installare le gemme Ruby da un CodeArtifact repository con gli strumenti o gem CLIbundle.

Installa Ruby gems con gem

Puoi usare la CLI RubyGems (gem) per installare rapidamente una versione specifica di una gemma Ruby dal tuo repository. CodeArtifact

Per installare Ruby gems da un repository con CodeArtifact gem

  1. In caso contrario, segui i passaggi indicati Configura RubyGems (gem) e Bundler () con bundle CodeArtifact per configurare la gem CLI per utilizzare il tuo CodeArtifact repository con le credenziali appropriate.

    Nota

    Il token di autorizzazione generato è valido per 12 ore. Dovrai crearne uno nuovo se sono trascorse 12 ore dalla creazione del token.

  2. Usa il seguente comando per installare Ruby gems da: CodeArtifact

    gem install my_ruby_gem --version 1.0.0

Installa Ruby gems con bundle

Puoi usare la CLI Bundler (bundle) per installare le gemme Ruby configurate nel tuo. Gemfile

Per installare Ruby gems da un repository con CodeArtifact bundle

  1. In caso contrario, segui i passaggi indicati Configura RubyGems (gem) e Bundler () con bundle CodeArtifact per configurare la bundle CLI per utilizzare il tuo CodeArtifact repository con le credenziali appropriate.

    Nota

    Il token di autorizzazione generato è valido per 12 ore. Dovrai crearne uno nuovo se sono trascorse 12 ore dalla creazione del token.

  2. Aggiungi l'URL CodeArtifact dell'endpoint del tuo repository al tuo annuncio per source installare Gemfile le gemme Ruby configurate dal tuo CodeArtifact repository e dai suoi upstream.

    source "https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/ruby/my_repo/"
                
gem 'my_ruby_gem'

  3. Usa il seguente comando per installare le gemme Ruby come specificato nel tuo: Gemfile

    bundle install

Pubblicazione delle gemme di Ruby su CodeArtifact

Usa la seguente procedura per pubblicare le gemme di Ruby in un CodeArtifact repository utilizzando la CLI. gem

  1. In caso contrario, segui i passaggi indicati Configura RubyGems (gem) e Bundler () con bundle CodeArtifact per configurare la gem CLI per utilizzare il tuo CodeArtifact repository con le credenziali appropriate.

    Nota

    Il token di autorizzazione generato è valido per 12 ore. Dovrai crearne uno nuovo se sono trascorse 12 ore dalla creazione del token.

  2. Usa il seguente comando per pubblicare le gemme di Ruby in un CodeArtifact repository. Nota che se non hai impostato la variabile di RUBYGEMS_HOST ambiente, devi fornire l'endpoint del CodeArtifact repository nell'opzione. --host

    gem push --key codeartifact_api_key my_ruby_gem-0.0.1.gem