View a markdown version of this page

Configure RubyGems e use o Bundler com CodeArtifact - CodeArtifact
Configure RubyGems (gem) e Bundler (bundle) com CodeArtifactInstalar gems RubyPublicar gems Ruby

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configure RubyGems e use o Bundler com CodeArtifact

Depois de criar um repositório no CodeArtifact, você pode usar RubyGems (gem) e Bundler (bundle) para instalar e publicar gems. Este tópico descreve como configurar os gerenciadores de pacotes para se autenticar e usar um CodeArtifact repositório.

Configure RubyGems (gem) e Bundler (bundle) com CodeArtifact

Para usar RubyGems (gem) ou Bundler (bundle) para publicar gems ou consumir gems AWS CodeArtifact, primeiro você precisará configurá-los com as informações do seu CodeArtifact repositório, incluindo credenciais para acessá-las. Siga as etapas em um dos procedimentos a seguir para configurar as ferramentas gem e a bundle CLI com as informações e credenciais do endpoint CodeArtifact do repositório.

Configurar RubyGems e agrupar usando as instruções do console

Você pode usar as instruções de configuração no console para conectar seus gerenciadores de pacotes Ruby ao seu CodeArtifact repositório. As instruções do console fornecem comandos personalizados que você pode executar para configurar seus gerenciadores de pacotes sem precisar encontrar e preencher suas CodeArtifact informações.

  1. Abra o AWS CodeArtifact console em https://console.aws.amazon.com/codesuite/codeartifact/home.

  2. No painel de navegação, selecione Repositórios e escolha o repositório que deseja usar para instalar ou enviar gems Ruby.

  3. Clique em Visualizar instruções de conexão.

  4. Selecione o seu sistema operacional.

  5. Escolha o cliente do gerenciador de pacotes Ruby que você deseja configurar com seu CodeArtifact repositório.

  6. Siga as instruções geradas para configurar o cliente gerenciador de pacotes para instalar gems Ruby ou publicar gems Ruby no repositório.

Configurar RubyGems e agrupar manualmente

Se você não puder ou não quiser usar as instruções de configuração do console, poderá usar as instruções a seguir para se conectar manualmente aos gerenciadores de pacotes Ruby ao seu CodeArtifact repositório.

  1. Em uma linha de comando, use o comando a seguir para buscar um token de CodeArtifact autorização e armazená-lo em uma variável de ambiente.

    • my_domainSubstitua pelo seu nome de CodeArtifact domínio.

    • 111122223333Substitua pelo ID da AWS conta do proprietário do domínio. Se você estiver acessando um repositório em um domínio de sua propriedade, não será necessário incluir --domain-owner. Para obter mais informações, consulte Domínios entre contas.

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

    • Windows (usando o shell de comando padrão):

      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

    • Janelas PowerShell:

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

  2. Para publicar gems Ruby em seu repositório, use o comando a seguir para buscar o endpoint do seu CodeArtifact repositório e armazená-lo na variável de ambiente. RUBYGEMS_HOST A CLI gem usa essa variável de ambiente para definir onde os gems são publicados.

    nota

    Como alternativa, em vez de usar a variável de ambiente RUBYGEMS_HOST, você pode fornecer o endpoint do repositório com a opção --host ao usar o comando gem push.

    • my_domainSubstitua pelo seu nome de CodeArtifact domínio.

    • 111122223333Substitua pelo ID da AWS conta do proprietário do domínio. Se você estiver acessando um repositório em um domínio de sua propriedade, não será necessário incluir --domain-owner. Para obter mais informações, consulte Domínios entre contas.

    • my_repoSubstitua pelo nome CodeArtifact do seu repositório.

    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

    Os comandos a seguir recuperam o endpoint do repositório, removem o / à direita e o armazenam em uma variável de ambiente.

    • Windows (usando o shell de comando padrão):

      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%

    • Janelas 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("/")

    O seguinte URL é um exemplo de endpoint de repositório:

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

    Para usar um endpoint de pilha dupla, use o endpoint codeartifact.region.on.aws.

  3. Para publicar gems Ruby em seu repositório, você deve se autenticar CodeArtifact com RubyGems editando seu ~/.gem/credentials arquivo para incluir seu token de autenticação. Crie um diretório ~/.gem/ e um arquivo ~/.gem/credentials se o diretório ou arquivo não existir.

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

    • Windows (usando o shell de comando padrão):

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

    • Janelas PowerShell:

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

  4. Para usar gem para instalar gems Ruby por meio do seu repositório, é necessário adicionar as informações do endpoint do repositório e o token de autenticação ao seu arquivo .gemrc. Você pode adicioná-las ao arquivo global (~/.gemrc) ou ao arquivo .gemrc do seu projeto. As CodeArtifact informações que você deve adicionar ao .gemrc são uma combinação do endpoint do repositório e do token de autenticação. O formato é o seguinte:

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

    • Você pode usar a variável de ambiente CODEARTIFACT_AUTH_TOKEN definida em uma etapa anterior para o token de autenticação.

    • Para buscar o endpoint do repositório, você poderá ler o valor da variável de ambiente RUBYGEMS_HOST definida anteriormente ou usar o seguinte comando get-repository-endpoint, substituindo os valores conforme necessário:

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

    Após obter o endpoint, use um editor de texto para adicionar aws:${CODEARTIFACT_AUTH_TOKEN}@ na posição apropriada. Após criar o endpoint do repositório e a string do token de autenticação, adicione-os à seção :sources: do seu arquivo .gemrc com o comando echo da seguinte forma:

    Atenção

    CodeArtifact não suporta a adição de repositórios como fontes usando o gem sources -add comando. Você deve adicionar a fonte diretamente ao arquivo.

    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 (usando o shell de comando padrão):

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

    • Janelas 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. Você deve configurar o Bundler com o URL do endpoint do repositório e o token de autenticação executando o seguinte comando bundle config ao usar o Bundler:

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

    • Windows (usando o shell de comando padrão):

      bundle config %RUBYGEMS_HOST% aws:%CODEARTIFACT_AUTH_TOKEN%

    • Janelas PowerShell:

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

Agora que você configurou RubyGems (gem) e Bundler (bundle) com seu CodeArtifact repositório, você pode usá-los para publicar e consumir gems Ruby de e para ele.

Instalando gemas Ruby a partir de CodeArtifact

Use os procedimentos a seguir para instalar gems Ruby a partir de um CodeArtifact repositório com as ferramentas ou gem CLIbundle.

Instalar gems Ruby com gem

Você pode usar a CLI RubyGems (gem) para instalar rapidamente uma versão específica de uma gem do Ruby a partir do seu repositório. CodeArtifact

Para instalar gems Ruby a partir de um repositório com CodeArtifact gem

  1. Caso contrário, siga as etapas Configure RubyGems (gem) e Bundler (bundle) com CodeArtifact para configurar a gem CLI para usar seu CodeArtifact repositório com as credenciais adequadas.

    nota

    O token de autorização gerado é válido por 12 horas. Você precisará criar um novo se tiverem passado 12 horas desde a criação do token.

  2. Use o comando a seguir para instalar gems Ruby a partir de: CodeArtifact

    gem install my_ruby_gem --version 1.0.0

Instalar gems Ruby com bundle

Você pode usar a CLI do Bundler (bundle) para instalar os gems Ruby configurados em Gemfile.

Para instalar gems Ruby a partir de um repositório com CodeArtifact bundle

  1. Caso contrário, siga as etapas Configure RubyGems (gem) e Bundler (bundle) com CodeArtifact para configurar a bundle CLI para usar seu CodeArtifact repositório com as credenciais adequadas.

    nota

    O token de autorização gerado é válido por 12 horas. Você precisará criar um novo se tiverem passado 12 horas desde a criação do token.

  2. Adicione a URL CodeArtifact do endpoint do repositório ao seu Gemfile as source para instalar gems Ruby configuradas do seu CodeArtifact repositório e de seus upstreams.

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

  3. Use o seguinte comando para instalar os gems Ruby conforme especificado em Gemfile:

    bundle install

Publicando gemas Ruby em CodeArtifact

Use o procedimento a seguir para publicar gems Ruby em um CodeArtifact repositório usando a CLI. gem

  1. Caso contrário, siga as etapas Configure RubyGems (gem) e Bundler (bundle) com CodeArtifact para configurar a gem CLI para usar seu CodeArtifact repositório com as credenciais adequadas.

    nota

    O token de autorização gerado é válido por 12 horas. Você precisará criar um novo se tiverem passado 12 horas desde a criação do token.

  2. Use o comando a seguir para publicar gems Ruby em um CodeArtifact repositório. Observe que, se você não definiu a variável de RUBYGEMS_HOST ambiente, deverá fornecer o endpoint CodeArtifact do repositório na --host opção.

    gem push --key codeartifact_api_key my_ruby_gem-0.0.1.gem