Pasos de configuración para HTTPS las conexiones a AWS CodeCommit con git-remote-codecommit - AWS CodeCommit
Paso 0: Instalar los requisitos previos para git-remote-codecommitPaso 1: Configuración inicial para CodeCommitPaso 2: Instalar git-remote-codecommitPaso 3: Conectarse a la CodeCommit consola y clonar el repositorioPasos a seguir a continuación

AWS CodeCommit ya no está disponible para nuevos clientes. Los clientes existentes de AWS CodeCommit pueden seguir utilizando el servicio con normalidad. Más información

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 HTTPS las conexiones a AWS CodeCommit con git-remote-codecommit

Si quieres conectarte CodeCommit mediante una cuenta raíz, un acceso federado o credenciales temporales, debes configurar el acceso mediantegit-remote-codecommit. Esta utilidad proporciona un método sencillo para insertar y extraer código de los CodeCommit repositorios mediante la extensión de Git. Es el método recomendado para admitir conexiones realizadas con acceso federado, proveedores de identidad y credenciales temporales. Para asignar permisos a identidades federadas, debe crear un rol y definir permisos para este. Cuando se autentica una identidad federada, se asocia la identidad al rol y se le conceden los permisos define el rol. Para obtener información sobre las funciones de la federación, consulte Crear una función para un proveedor de identidades externo (federación) en la Guía del IAM usuario. Si usa IAM Identity Center, configura un conjunto de permisos. Para controlar a qué pueden acceder sus identidades después de autenticarse, IAM Identity Center correlaciona el conjunto de permisos con un rol en. IAM Para obtener información acerca de los conjuntos de permisos, consulta Conjuntos de permisos en la Guía del usuario de AWS IAM Identity Center .

También se puede utilizar git-remote-codecommit con un IAM usuario. A diferencia de otros métodos de HTTPS conexión, git-remote-codecommit no requiere configurar las credenciales de Git para el usuario.

nota

Algunos IDEs no admiten el URL formato de clonación utilizado porgit-remote-codecommit. Puede que tenga que clonar manualmente los repositorios en su equipo local antes de poder trabajar con ellos en la forma que prefieraIDE. Para obtener más información, consulte Solución de problemas git-remote-codecommit y AWS CodeCommit.

Estos procedimientos se redactan partiendo del supuesto de que dispone de una cuenta de Amazon Web Services, ha creado al menos un repositorio en CodeCommit él y utiliza un IAM usuario con una política gestionada al conectarse a CodeCommit los repositorios. Para obtener información acerca de cómo configurar el acceso para usuarios federados y otros tipos de credenciales rotativas, consulte Conexión a AWS CodeCommit repositorios con credenciales rotativas.

Paso 0: Instalar los requisitos previos para git-remote-codecommit

Para poder utilizar git-remote-codecommit, debe instalar algunos componentes necesarios en el equipo local. Entre ellos se incluyen:

nota

Cuando instale Python en Windows, asegúrese de elegir la opción para agregar Python a la ruta.

git-remote-codecommit requiere pip versión 9.0.3 o posterior. Para comprobar su versión de pip, abra un terminal o línea de comandos y ejecute el siguiente comando:

pip --version

Puede ejecutar los dos comandos siguientes para actualizar su versión de pip a la última versión:

curl -O https://bootstrap.pypa.io/get-pip.py
python3 get-pip.py --user

Para trabajar con archivos, confirmaciones y otra información de los CodeCommit 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 Downloads.

nota

Git es una plataforma en evolución que se actualiza periódicamente. Ocasionalmente, un cambio en una función puede afectar a su forma de trabajar con CodeCommit ella. Si tienes problemas con una versión específica de Git CodeCommit, consulta la información enResolución de problemas.

Paso 1: Configuración inicial para CodeCommit

Siga estos pasos para crear un IAM usuario, configurarlo con las políticas adecuadas, obtener una clave de acceso y una clave secreta, e instalar y configurar el AWS CLI.

Para crear y configurar un IAM usuario para acceder CodeCommit

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

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

    nota

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

  3. Inicie sesión en AWS Management Console y abra la IAM consola en https://console.aws.amazon.com/iam/.

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

  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 AWSCodeCommitPowerUseru otra política administrada de CodeCommit acceso. Para obtener más información, consulte AWS políticas gestionadas para CodeCommit.

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

    Para obtener más información sobre las políticas CodeCommit gestionadas y sobre cómo compartir el acceso a los repositorios con otros grupos y usuarios, consulte Compartir un repositorio yAutenticación y control de acceso de 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 con él 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 AWS CLI y es compatible con 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 de la AWS CLI ha instalado, ejecute el aws --version comando.

    Para actualizar una versión anterior 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 de 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 IAM usuario con el que desea utilizarlas CodeCommit. Además, asegúrese de especificar Región de AWS dónde se encuentra el repositorio, por ejemplous-east-2. Cuando se le pregunte el formato de salida predeterminado, indique json. Por ejemplo, si está configurando un perfil para un IAM usuario:

    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 utilizarlos con 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 admitidos 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 las claves de acceso y las claves secretas, consulte ¿Cómo se obtienen las credenciales? y Administración de las claves de acceso de IAM los usuarios. Para obtener más información sobre los perfiles AWS CLI y, consulte Perfiles con nombre.

Paso 2: Instalar git-remote-codecommit

Siga estos pasos para instalar git-remote-codecommit.

Para instalar git-remote-codecommit

  1. En el terminal o en la línea de comandos, ejecute el comando:

    pip install git-remote-codecommit
    nota

    Según el sistema operativo y la configuración, es posible que deba ejecutar este comando con permisos elevados, como sudo, o usar el parámetro --user para realizar la instalación en un directorio que no requiera privilegios especiales, como su cuenta de usuario actual. Por ejemplo, en una computadora con Linux, macOS o Unix:

    sudo pip install git-remote-codecommit

    En un equipo con Windows:

    pip install --user git-remote-codecommit

  2. Supervise el proceso de instalación hasta que vea un mensaje de éxito.

Paso 3: Conectarse a la CodeCommit consola y clonar el repositorio

Si un administrador ya le ha enviado el clon URL git-remote-codecommit para usarlo en el CodeCommit repositorio, puede omitir la conexión a la consola y clonar el repositorio directamente.

Para conectarse a un CodeCommit repositorio

  1. Abre 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. Seleccione Clonar yURL, a continuación, elija el protocolo que desee utilizar al clonar o conectarse al repositorio. Esto copia el clonURL.

    • Copie el HTTPS URL si está utilizando las credenciales de Git con su IAM usuario o el ayudante de credenciales incluido con. AWS CLI

    • Copia el HTTPS (GRC) URL si estás usando el git-remote-codecommit comando en tu ordenador local.

    • Copie el SSH URL si está utilizando un par de claves SSH pública/privada con su IAM usuario.

    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 la Región de AWS que hayas iniciado sesión. Para crear un repositorio, consulte Cree un repositorio AWS CodeCommit o siga los pasos del tutorial Introducción a Git y CodeCommit.

  4. En el terminal o símbolo del sistema, clone el repositorio con el comando git clone. Usa HTTPS git-remote-codecommit URL lo que has copiado y el nombre del AWS CLI perfil, si has creado un perfil con nombre. Si no especifica un perfil, el comando presupone que el perfil es el predeterminado. El repositorio local se crea en un subdirectorio del directorio en el que ejecuta el comando. Por ejemplo, para clonar un repositorio llamado MyDemoRepo a un repositorio local llamado my-demo-repo:

    git clone codecommit://MyDemoRepo my-demo-repo

    Para clonar el mismo repositorio mediante un perfil llamado CodeCommitProfile: 

    git clone codecommit://CodeCommitProfile@MyDemoRepo my-demo-repo

    Para clonar un repositorio en un repositorio Región de AWS diferente al configurado en su perfil, incluya el Región de AWS nombre. Por ejemplo:

    git clone codecommit::ap-northeast-1://MyDemoRepo my-demo-repo

Pasos a seguir a continuación

Ha completado los requisitos previos. Siga los pasos que se indican Empezando con CodeCommit para empezar a usarlo CodeCommit.

Para aprender a crear e insertar su primera confirmación, consulte Crea una confirmación en AWS CodeCommit. Si no tiene experiencia en Git, es posible que quiera consultar la información de ¿Dónde puedo encontrar más información sobre Git? y Introducción a Git y AWS CodeCommit.