Pasos de configuración para las conexiones HTTPS a AWS CodeCommit repositorios en Linux, macOS o Unix con AWS CLI aplicación auxiliar de credenciales

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:

   • Perfiles con nombre

   • Uso de un rol de IAM en el AWS CLI

   • Comando Set

   • Conectarse a AWS CodeCommit repositorios con credenciales rotativas

   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.

1. Desde la terminal, usa Git para ejecutargit config, especificando el uso del ayudante de credenciales de Git con el perfil de AWS credenciales y habilitando el ayudante de credenciales de Git para enviar la ruta a los repositorios:

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

   sugerencia

   El ayudante de credenciales usa el perfil de AWS credenciales predeterminado o el rol de instancia de Amazon EC2. Puede especificar el perfil que se va a utilizar, como CodeCommitProfile, si ha creado un perfil de credenciales de AWS para utilizarse en CodeCommit:

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

   Si el nombre del perfil contiene espacios, asegúrese de incluir el nombre entre comillas (").

   Puede configurar perfiles por repositorio en lugar de hacerlo a nivel global. Para ello, utilice --local en lugar de --global.

   El auxiliar de credenciales de Git escribe el siguiente valor en ~/.gitconfig:

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

   importante

   Si desea utilizar un usuario de IAM diferente en la misma máquina local CodeCommit, debe volver a ejecutar el git config comando y especificar un perfil de credenciales diferente. AWS

2. Ejecute git config --global --edit para comprobar que el valor anterior se ha escrito en ~/.gitconfig. Si se ejecuta correctamente, debería ver el valor anterior (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.

   Si experimenta problemas después de configurar el auxiliar de credenciales, consulte Solución de problemas.

   importante

   Si es usuario de macOS, siga estos pasos para comprobar que el ayudante de credenciales está configurado correctamente.

3. Si usas macOS, usa HTTPS para conectarte a un CodeCommit repositorio. Después de conectarte a un CodeCommit repositorio con HTTPS por primera vez, el acceso posterior fallará después de unos 15 minutos. La versión de Git predeterminada en macOS utiliza Keychain Access para almacenar las credenciales. Por motivos de seguridad, la contraseña generada para acceder a tu CodeCommit repositorio es temporal, por lo que las credenciales almacenadas en el llavero dejan de funcionar al cabo de unos 15 minutos. Para evitar el uso de credenciales caducadas, deberá:

   • Instalar una versión de Git que no utilice la cadena de claves de forma predeterminada, o bien

   • Configura la utilidad Keychain Access para que no proporcione credenciales para CodeCommit los repositorios.

   1. Abra la utilidad Keychain Access. (Puede utilizar la función Finder para localizarlo).

   2. Busque la opción git-codecommit.us-east-2.amazonaws.com. Marque la fila, abra el menú contextual o haga clic con el botón derecho en ella y, a continuación, elija Get Info.

   3. Elija la pestaña Access Control.

   4. En Confirm before allowing access, elija git-credential-osxkeychain y, a continuación, seleccione el signo menos para eliminarla de la lista.

      nota

      Una vez que haya eliminado git-credential-osxkeychain de la lista, ve un mensaje emergente cada vez que ejecute un comando de Git. Elija Deny para continuar. Si las ventanas emergentes le interrumpen demasiado, estas son otras opciones:

      • Conéctese CodeCommit mediante SSH en lugar de HTTPS. Para obtener más información, consulte Para conexiones SSH en Linux, macOS o Unix.

      • En la utilidad Keychain Access, en la pestaña Access Control de git-codecommit.us-east-2.amazonaws.com, elija la opción Allow all applications to access this item (access to this item is not restricted). Esto impide que aparezcan ventanas emergentes, pero las credenciales acabarán caducando (de media, duran unos 15 minutos) y aparece un mensaje de error 403. Cuando suceda esto, elimine el elemento de la cadena de claves para restaurar la funcionalidad.

      • Para obtener más información, consulte Git para macOS: he configurado el ayudante de credenciales correctamente, pero ahora no tengo acceso a mi repositorio (403).

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 terminal y ejecute el comando git clone con la URL HTTPS que ha copiado. 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