Configura RubyGems y usa un paquete con CodeArtifact - CodeArtifact
Configure RubyGems (gem) y Bundler () bundle con CodeArtifactInstalación de gemas de RubyPublicar gemas de Ruby

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configura RubyGems y usa un paquete con CodeArtifact

Después de crear un repositorio en CodeArtifact, puedes usar RubyGems (gem) y Bundler (bundle) para instalar y publicar gemas. En este tema se describe cómo configurar los administradores de paquetes para autenticarse en un CodeArtifact repositorio y usarlo.

Configure RubyGems (gem) y Bundler () bundle con CodeArtifact

Si quieres usar RubyGems (gem) o Bundler (bundle) para publicar o consumir gemas AWS CodeArtifact, primero tendrás que configurarlas con la información de tu CodeArtifact repositorio, incluidas las credenciales para acceder a él. Siga los pasos de uno de los siguientes procedimientos para configurar las herramientas bundle CLI gem y las herramientas de la CLI con la información y las credenciales del punto final del CodeArtifact repositorio.

Configure RubyGems y agrupe mediante las instrucciones de la consola

Puedes usar las instrucciones de configuración de la consola para conectar tus administradores de paquetes de Ruby a tu CodeArtifact repositorio. Las instrucciones de la consola proporcionan comandos personalizados que puede ejecutar para configurar sus administradores de paquetes sin necesidad de buscar y completar su CodeArtifact información.

  1. Abre la AWS CodeArtifact consola en https://console.aws.amazon.com/codesuite/codeartifact/home.

  2. En el panel de navegación, selecciona Repositorios y, a continuación, elige el repositorio que quieres usar para instalar o insertar gemas de Ruby.

  3. Selecciona Ver instrucciones de conexión.

  4. Elige tu sistema operativo.

  5. Elige el cliente administrador de paquetes Ruby que deseas configurar con tu CodeArtifact repositorio.

  6. Sigue las instrucciones generadas para configurar el cliente administrador de paquetes para instalar gemas de Ruby o publicar gemas de Ruby en el repositorio.

Configura RubyGems y agrupa manualmente

Si no puedes o no quieres usar las instrucciones de configuración de la consola, puedes usar las siguientes instrucciones para conectarte manualmente a tus administradores de paquetes de Ruby a tu CodeArtifact repositorio.

  1. En una línea de comandos, usa el siguiente comando para obtener un token de CodeArtifact autorización y almacenarlo en una variable de entorno.

    • my_domainSustitúyalo por tu nombre CodeArtifact de dominio.

    • 111122223333Sustitúyelo por el ID de AWS cuenta del propietario del dominio. Si va a acceder a un repositorio de un dominio de su propiedad, no tiene que incluir --domain-owner. Para obtener más información, consulte Dominios entre cuentas.

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

    • Windows (mediante el intérprete de comandos predeterminado):

      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. Para publicar gemas de Ruby en tu repositorio, usa el siguiente comando para buscar el punto final de tu CodeArtifact repositorio y almacenarlo en la variable de RUBYGEMS_HOST entorno. La gem CLI utiliza esta variable de entorno para determinar dónde se publican las gemas.

    nota

    Como alternativa, en lugar de utilizar la variable de RUBYGEMS_HOST entorno, puedes proporcionar la --host opción al punto final del repositorio cuando utilices el gem push comando.

    • my_domainSustitúyalo por tu nombre de CodeArtifact dominio.

    • 111122223333Sustitúyelo por el ID de AWS cuenta del propietario del dominio. Si va a acceder a un repositorio de un dominio de su propiedad, no tiene que incluir --domain-owner. Para obtener más información, consulte Dominios entre cuentas.

    • my_repoSustitúyalo por el nombre de tu CodeArtifact repositorio.

    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

    Los siguientes comandos recuperan el punto final del repositorio, recortan el final y/, a continuación, lo almacenan en una variable de entorno.

    • Windows (mediante el intérprete de comandos predeterminado):

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

    La siguiente URL es un ejemplo de punto final del repositorio:

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

    Para usar un punto final de doble pila, use el codeartifact.region.on.aws punto final.

  3. Para publicar gemas de Ruby en tu repositorio, debes autenticarte CodeArtifact RubyGems editando tu ~/.gem/credentials archivo para incluir tu token de autenticación. Crea un ~/.gem/ directorio y un ~/.gem/credentials archivo si el directorio o el archivo no existen.

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

    • Windows (mediante el intérprete de comandos predeterminado):

      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. gemPara poder instalar gemas de Ruby desde tu repositorio, debes añadir la información del punto final del repositorio y el token de autenticación a tu .gemrc archivo. Puedes añadirlo al archivo global (~/.gemrc) o al archivo de tu proyecto.gemrc. La CodeArtifact información que debes añadir .gemrc es una combinación del punto final del repositorio y el token de autenticación. Tiene el siguiente formato:

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

    • Para el token de autenticación, puede usar la variable de CODEARTIFACT_AUTH_TOKEN entorno que se configuró en un paso anterior.

    • Para obtener el punto final del repositorio, puede leer el valor de la variable de RUBYGEMS_HOST entorno que se estableció anteriormente o puede usar el siguiente get-repository-endpoint comando, sustituyendo los valores según sea necesario:

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

    Una vez que tengas el punto final, usa un editor de texto para añadirlo aws:${CODEARTIFACT_AUTH_TOKEN}@ en la posición adecuada. Una vez que haya creado el punto final del repositorio y la cadena del token de autenticación, agréguelos a la :sources: sección del .gemrc archivo con el siguiente echo comando:

    aviso

    CodeArtifact no admite la adición de repositorios como fuentes mediante el gem sources -add comando. Debe añadir la fuente directamente al archivo.

    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 (mediante el intérprete de comandos predeterminado):

      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. Para usar Bundler, debes configurar Bundler con la URL del punto final del repositorio y el token de autenticación ejecutando el siguiente comando: bundle config

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

    • Windows (mediante el intérprete de comandos predeterminado):

      bundle config %RUBYGEMS_HOST% aws:%CODEARTIFACT_AUTH_TOKEN%

    • Windows: PowerShell

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

Ahora que has configurado RubyGems (gem) y Bundler (bundle) con tu CodeArtifact repositorio, puedes usarlos para publicar y consumir gemas de Ruby desde y hacia él.

Instalar gemas de Ruby desde CodeArtifact

Utilice los siguientes procedimientos para instalar gemas de Ruby desde un CodeArtifact repositorio con las herramientas gem o bundle CLI.

Instala las gemas de Ruby con gem

Puedes usar la CLI RubyGems (gem) para instalar rápidamente una versión específica de una gema Ruby desde tu CodeArtifact repositorio.

Para instalar gemas de Ruby desde un CodeArtifact repositorio con gem

  1. Si no lo ha hecho, siga los pasos que se indican Configure RubyGems (gem) y Bundler () bundle con CodeArtifact para configurar la gem CLI para que utilice el CodeArtifact repositorio con las credenciales adecuadas.

    nota

    El token de autorización generado es válido durante 12 horas. Deberá crear uno nuevo si han pasado 12 horas desde que se creó el token.

  2. Usa el siguiente comando para instalar Ruby gems desde CodeArtifact:

    gem install my_ruby_gem --version 1.0.0

Instala Ruby gems con bundle

Puede usar la CLI de Bundler (bundle) para instalar las gemas de Ruby que están configuradas en suGemfile.

Para instalar gemas de Ruby desde un CodeArtifact repositorio con bundle

  1. Si no lo ha hecho, siga los pasos que se indican Configure RubyGems (gem) y Bundler () bundle con CodeArtifact para configurar la bundle CLI para que utilice el CodeArtifact repositorio con las credenciales adecuadas.

    nota

    El token de autorización generado es válido durante 12 horas. Deberá crear uno nuevo si han pasado 12 horas desde que se creó el token.

  2. Agrega la URL CodeArtifact del punto final de tu repositorio a la Gemfile tuya source para instalar las gemas de Ruby configuradas desde tu CodeArtifact repositorio y sus fuentes de acceso.

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

  3. Usa el siguiente comando para instalar las gemas de Ruby tal y como se especifica en tuGemfile:

    bundle install

Publicar gemas de Ruby en CodeArtifact

Utilice el siguiente procedimiento para publicar gemas de Ruby en un CodeArtifact repositorio mediante la gem CLI.

  1. Si no lo ha hecho, siga los pasos que se indican Configure RubyGems (gem) y Bundler () bundle con CodeArtifact para configurar la gem CLI para que utilice el CodeArtifact repositorio con las credenciales adecuadas.

    nota

    El token de autorización generado es válido durante 12 horas. Deberá crear uno nuevo si han pasado 12 horas desde que se creó el token.

  2. Usa el siguiente comando para publicar las gemas de Ruby en un CodeArtifact repositorio. Tenga en cuenta que si no configuró la variable de RUBYGEMS_HOST entorno, debe proporcionar el punto final del CodeArtifact repositorio en la --host opción.

    gem push --key codeartifact_api_key my_ruby_gem-0.0.1.gem