View a markdown version of this page

Pasos de configuración para las conexiones HTTPS a AWS CodeCommit repositorios en Windows con AWS CLI aplicación auxiliar de credenciales - AWS CodeCommit
Paso 1: Configuración inicial para CodeCommitPaso 2: Instalar GitPaso 3: Configurar el ayudante de credencialesPaso 4: Conéctese a la CodeCommit consola y clone el repositorioSiguientes pasos

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.

Pasos de configuración para las conexiones HTTPS a AWS CodeCommit repositorios en Windows con AWS CLI aplicación auxiliar de credenciales

Antes de poder conectarse AWS CodeCommit por primera vez, debe completar los pasos de configuración iniciales. Para la mayoría de usuarios, se puede realizar fácilmente siguiendo los pasos que se detallan en Para usuarios HTTPS mediante credenciales de Git. Sin embargo, si desea conectarse CodeCommit mediante una cuenta raíz, un acceso federado o credenciales temporales, puede utilizar el asistente de credenciales que se incluye en. AWS CLI

nota

Si bien el ayudante de credenciales es un método compatible para conectarse CodeCommit mediante el acceso federado, un proveedor de identidad o credenciales temporales, el método recomendado es instalar y usar la utilidad. git-remote-codecommit Para obtener más información, consulte Pasos de configuración para las conexiones HTTPS a AWS CodeCommit con git-remote-codecommit.

En este tema se explican los pasos para instalar AWS CLI, configurar el equipo y el AWS perfil, conectarse a un CodeCommit repositorio y clonar ese repositorio en su equipo, lo que también se conoce como crear un repositorio local. Si Git es nuevo para usted, es posible que quiera consultar la información que aparece en ¿Dónde puedo encontrar más información sobre Git?.

Paso 1: Configuración inicial para CodeCommit

Siga estos pasos para configurar una cuenta de Amazon Web Services, crear y configurar un usuario de IAM e instalar la AWS CLI. AWS CLI Incluye un ayudante de credenciales que puedes configurar para las conexiones HTTPS a tus CodeCommit repositorios.

Para crear y configurar un usuario de IAM para acceder CodeCommit

  1. Para crear una cuenta de Amazon Web Services, vaya a http://aws.amazon.com y seleccione Registrarse.

  2. Cree un usuario de IAM o use uno existente en su cuenta de Amazon Web Services. Asegúrese de que tiene un ID de clave de acceso y una clave de acceso secreta asociados a ese usuario de IAM. Para obtener más información, consulte Creación de un usuario de IAM en su cuenta de Amazon Web Services.

    nota

    CodeCommit requiere AWS Key Management Service. Si utilizas un usuario de IAM existente, asegúrate de que no haya políticas adjuntas al usuario que nieguen expresamente las AWS KMS acciones requeridas por CodeCommit él. Para obtener más información, consulte AWS KMS y cifrado.

  3. Inicia sesión en Consola de administración de AWS y abre la consola de IAM en. https://console.aws.amazon.com/iam/

  4. En la consola de IAM, en el panel de navegación, elija Usuarios y, a continuación, elija el usuario de IAM cuyo acceso desea configurar. CodeCommit

  5. En la pestaña Permissions, seleccione Add Permissions.

  6. En Grant permissions, elija Attach existing policies directly.

  7. En la lista de políticas, seleccione AWSCodeCommitPowerUser u otra política gestionada para CodeCommit acceder. Para obtener más información, consulte AWS políticas administradas para CodeCommit.

    Una vez que haya seleccionado la política que desee asociar, seleccione Siguiente: Revisar para revisar la lista de políticas que se van a asociar al usuario de IAM. Si la lista es correcta, seleccione Add permissions.

    Para obtener más información sobre las políticas CodeCommit administradas y cómo compartir el acceso a los repositorios con otros grupos y usuarios, consulta Compartir un repositorio yAutenticación y control de acceso para AWS CodeCommit.

Para instalar y configurar el AWS CLI

  1. En su máquina local, descargue e instale el AWS CLI. Este es un requisito previo para interactuar CodeCommit desde la línea de comandos. Le recomendamos que instale la versión 2 de AWS CLI . Es la versión principal más reciente del AWS CLI y admite todas las funciones más recientes. Es la única versión de la AWS CLI que admite el uso de una cuenta raíz, un acceso federado o credenciales temporales congit-remote-codecommit.

    Para obtener más información, consulte Cómo configurar la interfaz de línea de AWS comandos.

    nota

    CodeCommit solo funciona con AWS CLI las versiones 1.7.38 y posteriores. Como práctica recomendada, instale o actualice AWS CLI a la última versión disponible. Para determinar qué versión AWS CLI tiene instalada, ejecute el aws --version comando.

    Para actualizar una versión anterior del AWS CLI a la versión más reciente, consulte Instalación del AWS Command Line Interface.

  2. Ejecute este comando para comprobar que los CodeCommit comandos correspondientes a AWS CLI están instalados.

    aws codecommit help

    Este comando devuelve una lista de CodeCommit comandos.

  3. Configure el AWS CLI con un perfil mediante el configure comando, de la siguiente manera:.

    aws configure

    Cuando se le solicite, especifique la clave de AWS acceso y la clave de acceso AWS secreta del usuario de IAM con CodeCommit el que se va a utilizar. Además, asegúrese de especificar Región de AWS dónde se encuentra el repositorio, por ejemplo. us-east-2 Cuando se le pregunte el formato de salida predeterminado, indique json. Por ejemplo, si está configurando un perfil para un usuario de IAM:

    AWS Access Key ID [None]: Type your IAM user AWS access key ID here, and then press Enter
AWS Secret Access Key [None]: Type your IAM user AWS secret access key here, and then press Enter
Default region name [None]: Type a supported region for CodeCommit here, and then press Enter
Default output format [None]: Type json here, and then press Enter

    Para obtener más información sobre la creación y configuración de perfiles para usarlos con el AWS CLI, consulte lo siguiente:

    Para conectarse a un repositorio o a un recurso de otro Región de AWS, debe volver a configurarlo AWS CLI con el nombre de región predeterminado. Los nombres de región predeterminados compatibles CodeCommit incluyen:

    • us-east-2

    • us-east-1

    • eu-west-1

    • us-west-2

    • ap-northeast-1

    • ap-southeast-1

    • ap-southeast-2

    • ap-southeast-3

    • me-central-1

    • eu-central-1

    • ap-northeast-2

    • sa-east-1

    • us-west-1

    • eu-west-2

    • ap-south-1

    • ap-south-1

    • ca-central-1

    • us-gov-west-1

    • us-gov-east-1

    • eu-north-1

    • ap-east-1

    • me-south-1

    • cn-north-1

    • cn-northwest-1

    • eu-south-1

    • ap-northeast-3

    • af-south-1

    • il-central-1

    Para obtener más información sobre CodeCommit y Región de AWS, consulteRegiones y puntos de conexión de Git. Para obtener más información sobre IAM, claves de acceso y claves secretas, consulte ¿Cómo puedo obtener credenciales? y Gestión de claves de acceso para usuarios de IAM. Para obtener más información sobre los perfiles AWS CLI y, consulte Perfiles con nombre asignado.

Paso 2: Instalar Git

Para trabajar con los archivos, las confirmaciones y otra información de CodeCommit los repositorios, debes instalar Git en tu máquina local. CodeCommit es compatible con las versiones 1.7.9 y posteriores de Git. La versión 2.28 de Git admite la configuración del nombre de la ramificación para las confirmaciones iniciales. Recomendamos usar una versión reciente de Git.

Para instalar Git, le recomendamos sitios web como Git for Windows. Si utiliza este enlace para instalar Git, puede aceptar todos los ajustes predeterminados de la instalación excepto los siguientes:

nota

Git es una plataforma en evolución que se actualiza periódicamente. En ocasiones, un cambio en una función puede afectar a la forma en que funciona. CodeCommit Si tienes problemas con una versión específica de Git CodeCommit, revisa la información enSolución de problemas.

Paso 3: Configurar el ayudante de credenciales

AWS CLI Incluye un ayudante de credenciales de Git con el que puedes usar. CodeCommit El ayudante de credenciales de Git requiere un perfil de AWS credenciales que almacene una copia del identificador de la clave de acceso y la clave de AWS acceso AWS secreta de un usuario de IAM (junto con un Región de AWS nombre predeterminado y un formato de salida predeterminado). El ayudante de credenciales de Git usa esta información para autenticarse automáticamente, de CodeCommit modo que no es necesario que introduzcas esta información cada vez que utilices Git para interactuar con él. CodeCommit

  1. Abre una línea de comandos y usa Git para ejecutargit config, especificando el uso del ayudante de credenciales de Git con el perfil de credenciales, lo que permite al ayudante de AWS credenciales de Git enviar la ruta a los repositorios:

    git config --global credential.helper "!aws codecommit credential-helper $@"
git config --global credential.UseHttpPath true

    El auxiliar de credenciales de Git escribe lo siguiente en el archivo .gitconfig:

    [credential]    
    helper = !aws codecommit credential-helper $@ 
    UseHttpPath = true
    importante

    • Si utiliza un emulador de Bash en lugar de la línea de comandos de Windows, debe utilizar comillas simples en lugar de comillas dobles.

    • El ayudante de credenciales usa el perfil predeterminado o el rol de instancia de Amazon EC2 AWS . Si ha creado un perfil de AWS credenciales para usarlo, por ejemploCodeCommitProfile, puede modificar el comando de la siguiente manera para usarlo en su lugar:

      git config --global credential.helper "!aws codecommit credential-helper --profile CodeCommitProfile $@"

      Al hacerlo, se escribe lo siguiente en el archivo .gitconfig:

      [credential]    
    helper = !aws codecommit credential-helper --profile=CodeCommitProfile $@ 
    UseHttpPath = true

    • Si su nombre de perfil contiene espacios, deberá editar el archivo .gitconfig después de ejecutar este comando para definirlo entre comillas simples ('). De lo contrario, el auxiliar de credenciales no funcionará.

    • Si la instalación de Git para Windows incluye el Administrador de credenciales de Git, ve errores 403 o instrucciones para proporcionar credenciales en el Administrador de credenciales después de los primeros intentos de conexión. El método más fiable para resolver este problema es desinstalar y reinstalar Git para Windows sin la opción del Administrador de credenciales de Git, ya que no es compatible con CodeCommit. Si quieres conservar la utilidad Git Credential Manager, debes realizar pasos de configuración adicionales para utilizarla también CodeCommit, incluida la modificación manual del archivo .gitconfig para especificar el uso del ayudante de credenciales cuando te conectes a ella. AWS CodeCommit CodeCommit Elimine todas las credenciales almacenadas en el Administrador de credenciales (puede encontrar esta utilidad en el Panel de control). Una vez que haya eliminado las credenciales almacenadas, añada las siguientes a su archivo .gitconfig, guárdelo y, a continuación, intente conectarse de nuevo desde una ventana de símbolo del sistema:

      [credential "https://git-codecommit.us-east-2.amazonaws.com"]
    helper = !aws codecommit credential-helper $@ 
    UseHttpPath = true

[credential "https://git-codecommit.us-east-1.amazonaws.com"]
    helper = !aws codecommit credential-helper $@ 
    UseHttpPath = true

      Es posible que tenga que volver a configurar los valores de git config especificando --system en lugar de --global o --local para que todas las conexiones funcionen según lo previsto.

    • Si quieres usar diferentes usuarios de IAM en la misma máquina local CodeCommit, debes especificar en git config --local lugar de cada perfil de credenciales git config --global y ejecutarlo. AWS

  2. Ejecute git config --global --edit para verificar que los valores anteriores se han escrito en el archivo .gitconfig para su perfil de usuario (de forma predeterminada, %HOME%\.gitconfig o drive:\Users\UserName\.gitconfig). Si se ejecuta correctamente, debería ver los valores anteriores (además de otros valores que podrían existir en el archivo de configuración global de Git). Para salir, escriba :q y, a continuación, pulse Intro.

Paso 4: Conéctese a la CodeCommit consola y clone el repositorio

Si un administrador ya te ha enviado el nombre y los detalles de conexión del CodeCommit repositorio, puedes saltarte este paso y clonar el repositorio directamente.

Para conectarse a un CodeCommit repositorio

  1. Abra la CodeCommit consola en https://console.aws.amazon.com/codesuite/codecommit/home.

  2. En el selector de regiones, elija el Región de AWS lugar donde se creó el repositorio. Los repositorios son específicos de un Región de AWS. Para obtener más información, consulte Regiones y puntos de conexión de Git.

  3. Encuentre en la lista el repositorio con el que desea establecer la conexión y selecciónelo. Elija Clone URL (Clonar URL), y, a continuación, elija el protocolo que desea utilizar al clonar o conectarse al repositorio. Con esto se copia la URL clonada.

    • Copie la URL HTTPS si utiliza credenciales de Git con su usuario de IAM o el ayudante de credenciales incluido con AWS CLI.

    • Copie la dirección URL HTTPS (GRC) si utiliza el comando git-remote-codecommit en su equipo local.

    • Copia la URL de SSH si utilizas un par de public/private claves SSH con tu usuario de IAM.

    nota

    Si ves una página de bienvenida en lugar de una lista de repositorios, significa que no hay ningún repositorio asociado a tu AWS cuenta en el Región de AWS lugar en el que has iniciado sesión. Para crear un repositorio, consulte Cree un AWS CodeCommit repositorio o siga los pasos del tutorial Empezar a usar Git y CodeCommit.

  4. Abra un símbolo del sistema y ejecute el comando git clone con la URL HTTPS que ha copiado. El repositorio local se crea en un subdirectorio del directorio en el que ejecuta el comando. Por ejemplo, para clonar un repositorio con el nombre MyDemoRepo de un repositorio local denominado my-demo-repo en la región Este de EE. UU. (Ohio):

    git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

    En algunas versiones de Windows, es posible que aparezca un mensaje emergente que solicite su nombre de usuario y contraseña. Este es el sistema de gestión de credenciales integrado para Windows, pero no es compatible con el auxiliar de credenciales de AWS CodeCommit. Elija Cancelar.

Siguientes pasos

Ha completado los requisitos previos. Sigue los pasos que se indican a continuación Cómo empezar con CodeCommit para empezar a usarlo CodeCommit.