View a markdown version of this page

Pasos de configuración para las conexiones HTTPS a AWS CodeCommit con git-remote-codecommit - AWS CodeCommit
Paso 0: Instalar los componentes necesarios para git-remote-codecommitPaso 1: Configuración inicial para CodeCommitPaso 2: Instalar git-remote-codecommitPaso 3: 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 con git-remote-codecommit

Si desea conectarse CodeCommit mediante una cuenta raíz, un acceso federado o credenciales temporales, debe configurar el acceso mediante. git-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 acerca de roles de federación, consulte Crear un rol para un proveedor de identidad de terceros (federación) en la Guía de usuario de IAM. Si utiliza el IAM Identity Center, debe configurar un conjunto de permisos. IAM Identity Center correlaciona el conjunto de permisos con un rol en IAM para controlar a qué pueden acceder las identidades después de autenticarse. 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 usuario de IAM. A diferencia de otros métodos de conexión HTTPS, git-remote-codecommitno requiere la configuración de credenciales de Git para el usuario.

nota

Algunos IDE no admiten el formato de URL de clonación utilizado por git-remote-codecommit. Es posible que tenga que clonar manualmente los repositorios en el equipo local para poder trabajar con ellos en el IDE de su elección. Para obtener más información, consulte Solución de problemas de git-remote-codecommit y AWS CodeCommit.

Estos procedimientos se escriben partiendo del supuesto de que tienes una cuenta de Amazon Web Services, has creado al menos un repositorio en CodeCommit ella y utilizas un usuario de IAM con una política gestionada cuando te conectas 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 Conectarse a AWS CodeCommit repositorios con credenciales rotativas.

Paso 0: Instalar los componentes necesarios 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 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 Downloads.

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 1: Configuración inicial para CodeCommit

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

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-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: Conéctese a la CodeCommit consola y clone el repositorio

Si un administrador ya te ha enviado la URL de clonación git-remote-codecommit para utilizarla en el CodeCommit repositorio, puedes saltarte la conexión a la consola y clonar el repositorio directamente.

Para conectarte 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. En el terminal o símbolo del sistema, clone el repositorio con el comando git clone. Usa la URL HTTPS git-remote-codecommit que copiaste y el nombre del AWS CLI perfil, si creaste 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 denominado MyDemoRepo en un repositorio local llamado my-demo-repo:

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

    Para clonar el mismo repositorio con un perfil llamado: CodeCommitProfile 

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

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

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

Siguientes pasos

Ha completado los requisitos previos. Sigue los pasos que se indican Cómo empezar con CodeCommit a continuación 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 Empezar a usar Git y AWS CodeCommit.