Migrar un repositorio de Git a AWS CodeCommit

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. 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 en el que desea crear el repositorio. Para obtener más información, consulte Regiones y puntos de conexión de Git.

3. En la página Repositorios, seleccione Crear repositorio.

4. En la página Create repository (Crear repositorio), en el campo Repository name (Nombre de repositorio), escriba un nombre para el repositorio.

   nota

   Los nombres de repositorio distinguen entre mayúsculas y minúsculas. El nombre debe ser único en la Región de AWS y de su cuenta de Amazon Web Services.

5. (Opcional) En Descripción, introduzca una descripción para el repositorio. Esto puede ayudarle a usted y a otros usuarios a conocer el propósito del repositorio.

   nota

   El campo de descripción muestra Marcado en la consola y acepta todos los caracteres HTML y caracteres Unicode válidos. Si es un desarrollador de aplicaciones que usa las BatchGetRepositories API GetRepository O y planea mostrar el campo de descripción del repositorio en un navegador web, consulte la referencia de la CodeCommit API.

6. (Opcional) Elige Agregar etiqueta para agregar una o más etiquetas de repositorio (una etiqueta de atributo personalizada que te ayuda a organizar y administrar tus AWS recursos) a tu repositorio. Para obtener más información, consulte Etiquetar repositorios en AWS CodeCommit.

7. (Opcional) Amplíe Configuración adicional para especificar si se debe usar la clave predeterminada Clave administrada de AWS o la clave gestionada por el cliente para cifrar y descifrar los datos de este repositorio. Si eliges usar tu propia clave gestionada por el cliente, debes asegurarte de que esté disponible en el Región de AWS lugar donde estás creando el repositorio y de que la clave esté activa. Para obtener más información, consulte AWS Key Management Service y cifrado para AWS CodeCommit repositorios.

8. (Opcional) Seleccione Habilitar Amazon CodeGuru Reviewer para Java y Python si este repositorio contiene código Java o Python y desea que CodeGuru Reviewer lo analice. CodeGuru Reviewer usa varios modelos de aprendizaje automático para detectar defectos en el código y sugerir mejoras y correcciones en las solicitudes de cambios. Para obtener más información, consulte la guía del usuario de Amazon CodeGuru Reviewer .

9. Seleccione Crear.

1. Desde la terminal o la línea de comandos de tu computadora local, ejecuta el git clone comando con la --mirror opción de clonar una copia simple del repositorio remoto en una nueva carpeta llamadaaws-codecommit-demo. Se trata de un repositorio vacío concebido solamente para la migración. No es el repositorio local en el que interactuar con el repositorio migrado. CodeCommit Puede crearlo más adelante, una vez finalizada la migración CodeCommit a.

   El siguiente ejemplo clona una aplicación de demostración alojada en GitHub (https://github.com/awslabs/aws-demo-php-simple-app.git) en un repositorio local en un directorio denominadoaws-codecommit-demo.

   git clone --mirror https://github.com/awslabs/aws-demo-php-simple-app.git aws-codecommit-demo

2. Cambie los directorios por el directorio en el que ha realizado la clonación.

   cd aws-codecommit-demo

3. Ejecuta el git push comando especificando la URL y el nombre del CodeCommit repositorio de destino y la --all opción. (Esta es la URL que copió en Paso 1: Crea un repositorio CodeCommit).

   Por ejemplo, si asignaste un nombre a tu repositorio MyClonedRepository y estás configurado para usar HTTPS, ejecutarás el siguiente comando:

   git push https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyClonedRepository --all

   nota

   La opción --all solo envía todas las ramificaciones al repositorio. No envía otras referencias, como, por ejemplo, etiquetas. Si desea enviar etiquetas, espere hasta que se haya completado el envío inicial y, a continuación, envíe de nuevo, esta vez con la opción --tags.

   git push ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyClonedRepository --tags

   Para obtener más información, consulte Git push en el sitio web de Git. Para obtener más información sobre el envío de grandes repositorios, especialmente cuando se envían todas las referencias a la vez (por ejemplo, con la opción --mirror), consulte Migrar de forma incremental un repositorio.

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

2. En Repositorios, elija el nombre del repositorio (por ejemplo,MyClonedRepository).

3. Vea los archivos del repositorio para las ramificaciones, las URL de clonación, la configuración y mucho más.

   

Creación de una política administrada por el cliente para su repositorio

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

2. En el área de navegación Dashboard, elija Policies y, a continuación, seleccione Create Policy.

3. En la página Crear política, seleccione Importar política administrada.

4. En la página Importar políticas administradas, en Filtrar políticas, introduzca AWSCodeCommitPowerUser. Seleccione el botón situado junto al nombre de la política y, a continuación, seleccione Importar.

5. En la página Crear política, elija JSON. Sustituya la parte «*» de la Resource línea correspondiente a CodeCommit las acciones por el nombre del recurso de Amazon (ARN) del CodeCommit repositorio, tal y como se muestra a continuación:

   "Resource": [
    "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo"
    ]

   sugerencia

   Para encontrar el ARN del CodeCommit repositorio, vaya a la CodeCommit consola, elija el nombre del repositorio en la lista y, a continuación, seleccione Configuración. Para obtener más información, consulte Visualización de la información de los repositorios.

   Si desea que esta política se aplique a más de un repositorio, añada cada repositorio como recurso y especifique su ARN. Añada una coma entre cada declaración de recursos, tal y como se muestra aquí:

   "Resource": [
    "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo",
    "arn:aws:codecommit:us-east-2:111111111111:MyOtherDemoRepo"
    ]

   Cuando haya terminado de editar, seleccione Revisar la política.

6. En la página Revisar la política, en Nombre, introduzca un nombre nuevo para la política (por ejemplo,AWSCodeCommitPowerUser-MyDemoRepo). Opcionalmente, puede proporcionar una descripción opcional para esta política.

7. Seleccione Crear política.

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

2. En el área de navegación Dashboard, elija Groups y, a continuación, seleccione Create New Group.

3. En la página Set Group Name (Establecer nombre del grupo), en Group Name (Nombre del grupo), introduzca un nombre para el grupo (por ejemplo, MyDemoRepoGroup) y seleccione Next Step (Siguiente paso). Tenga en cuenta la posibilidad de incluir el nombre del repositorio como parte del nombre del grupo.

   nota

   Este nombre debe ser exclusivo de una cuenta de Amazon Web Services.

4. Selecciona la casilla situada junto a la política gestionada por el cliente que creaste en la sección anterior (por ejemplo, AWSCodeCommitPowerUser-MyDemoRepo).

5. En la página Review, elija Create Group. IAM crea este grupo con las políticas especificadas ya adjuntas. El grupo aparece en la lista de grupos asociados con su cuenta de Amazon Web Services.

6. Seleccione su grupo de la lista.

7. En la página de resumen de grupo, elija la pestaña Users y, continuación, seleccione Add Users to Group. En la lista que muestra todos los usuarios asociados a tu cuenta de Amazon Web Services, selecciona las casillas situadas junto a los usuarios a los que quieres permitir el acceso al CodeCommit repositorio y, a continuación, selecciona Agregar usuarios.

   sugerencia

   Puede usar el cuadro de búsqueda para encontrar rápidamente a los usuarios por su nombre.

8. Cuando haya agregado sus usuarios, cierre la consola de IAM.

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. En la página Repositories (Repositorios), elija el repositorio que desea compartir.

4. En Clone URL (URL de clonación), elija el protocolo que desee que utilicen los usuarios. Esto copiará la URL de clonación del protocolo de conexión.

5. Envía a tus usuarios la URL clonada junto con cualquier otra instrucción, como instalar AWS CLI, configurar un perfil o instalar Git. Asegúrese de incluir la información de configuración para el protocolo de conexión (por ejemplo, HTTPS).