Migrar contenido local o sin versionar a AWS CodeCommit - AWS CodeCommit

Migrar contenido local o sin versionar a AWS CodeCommit

Los procedimientos que se describen en este tema muestran cómo migrar un proyecto existente, o de contenido local, de su equipo a un Repositorio de CodeCommit. Como parte de este proceso:

  • Completará la configuración inicial necesaria para CodeCommit.

  • Crear un CodeCommit repositorio.

  • Coloque una carpeta local bajo control de versiones de Git y pulse el contenido de esa carpeta en el CodeCommit repositorio.

  • Ver archivos en el CodeCommit repositorio.

  • Compartirá el repositorio de CodeCommit con su equipo


            Migración de un proyecto local a CodeCommit

Paso 0: Configuración requerida para acceso a CodeCommit

Antes de poder migrar contenido local a CodeCommit, debe crear y configurar un IAM usuario para CodeCommit y configure su ordenador local para acceder a. También deberá instalar la AWS CLI para administrar CodeCommit. Aunque puede realizar la mayoría CodeCommit tareas sin ella, el AWS CLI ofrece flexibilidad al trabajar con Git.

Si ya ha realizado las configuraciones necesarias para CodeCommit, puede pasar directamente a Paso 1. Crear un CodeCommit repositorio.

Para crear y configurar un usuario IAM para acceder a CodeCommit

  1. Crear un AWS cuenta al dirigirse a http://aws.amazon.com y elegir Registrarse.

  2. Crear un IAM usuario, o utilice uno existente, en su AWS cuenta. Asegúrese de tener un ID de clave de acceso y una clave de acceso secreta asociada con IAM usuario. Para obtener más información, consulte Creando un IAM Usuario en su AWS Cuenta.

    nota

    CodeCommit requiere AWS Key Management Service. Si está utilizando un IAM usuario, asegurarse de que no haya políticas vinculadas al usuario que deniegue expresamente la AWS KMS acciones requeridas por CodeCommit. Para obtener más información, consulte AWS KMS y cifrado.

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

  4. En el IAM consola, en el panel de navegación, elegir Usuarios, y luego elegir el IAM usuario que desea configurar para CodeCommit acceso.

  5. En el Permisos pestaña, elegir Añadir permisos.

  6. En Otorgar permisos, elegir Adjuntar políticas existentes directamente.

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

    Una vez que haya seleccionado la política que desea adjuntar, elija Siguiente: Revisión para revisar la lista de políticas que se adjuntan a la IAM usuario. Si la lista es correcta, elija Añadir permisos.

    Para obtener más información sobre CodeCommit políticas gestionadas y compartir acceso a repositorios con otros grupos y usuarios, consulte Compartir un repositorio y Autenticación y control de acceso de AWS CodeCommit.

Para instalar y configurar la AWS CLI

  1. En el equipo local, descargue e instale la AWS CLI. Se trata de un requisito previo para interactuar con CodeCommit en la línea de comandos. Para obtener más información, consulte Prepararse con el AWS Interfaz de línea de comandos.

    nota

    CodeCommit solo funciona con las versiones AWS CLI de la 1.7.38 y versiones posteriores. Como práctica recomendada, instale o actualice la AWS CLI a la versión más reciente disponible. Para determinar qué versión del AWS CLI que ha instalado, ejecute el aws --version comando.

    Para actualizar una versión anterior de la AWS CLI a la última versión, consulte Instalación de la AWS Command Line Interface.

  2. Ejecute este comando para verificar el CodeCommit comandos para el AWS CLI están instalados:

    aws codecommit help

    Este comando debe devolver una lista de CodeCommit comandos.

  3. Configure el AWS CLI con un perfil utilizando el configure comando, como se indica a continuación:

    aws configure

    Cuando se le solicite, especifique el AWS clave de acceso y AWS clave de acceso secreta del IAM usuario que utilizar con CodeCommit. Asegúrese también de especificar la región de AWS donde existe el repositorio, como us-east-2. Cuando se le solicite el formato de salida predeterminado, especifique json. Por ejemplo:

    AWS Access Key ID [None]: Type your target AWS access key ID here, and then press Enter AWS Secret Access Key [None]: Type your target 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 acerca de la creación y configuración de perfiles para utilizarlos con la AWS CLI, consulte lo siguiente:

    Para conectarse a un repositorio o a un recurso en otra región de AWS, debe volver a configurar la AWS CLI con el nombre de la región predeterminada. Entre los nombres de las regiones predeterminadas de CodeCommit compatibles se incluyen:

    • us-east-2

    • us-east-1

    • eu-west-1

    • us-west-2

    • ap-northeast-1

    • ap-southeast-1

    • ap-southeast-2

    • eu-central-1

    • ap-northeast-2

    • sa-east-1

    • us-west-1

    • eu-west-2

    • 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

    Para obtener más información sobre CodeCommit y las regiones de AWS, consulte Variables de conexión de regiones y Git. Para obtener más información sobre IAM, teclas de acceso y teclas secretas, consulte ¿Cómo obtengo credenciales? y Gestión de claves de acceso para IAM Usuarios. Para obtener más información sobre el AWS CLI y perfiles, consulte Perfiles identificados.

A continuación, deberá instalar Git.

  • En Linux, macOS, or Unix:

    Para trabajar con archivos, validaciones y otra información en los repositorios de CodeCommit deberá instalar Git en su máquina local. CodeCommit admite las versiones de Git 1.7.9 y posteriores. 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 característica podría afectar a la forma en que trabaja CodeCommit. Si encuentra problemas con una versión específica de Git y CodeCommit, consulte la información de Solución de problemas.

  • Para Windows:

    Para trabajar con archivos, validaciones y otra información en los repositorios de CodeCommit deberá instalar Git en su máquina local. CodeCommit admite las versiones de Git 1.7.9 y posteriores. Recomendamos usar una versión reciente de Git.

    Para instalar Git, le recomendamos que utilice sitios web como Git for Windows (Git para Windows). Si utiliza este enlace para instalar Git, puede aceptar toda la configuración predeterminada de la instalación a excepción de lo siguiente:

    • Cuando se solicite durante el paso Adjusting your PATH environment (Ajustar el entorno PATH) seleccione la opción para usar Git desde el símbolo del sistema.

    • (Opcional) Si pretende utilizar HTTPS con el asistente de credenciales que se incluye en la AWS CLI en lugar de configurar las credenciales de Git para CodeCommit, en la página Configuring extra options (Configuración de opciones adicionales), asegúrese de que la opción Enable Git Credential Manager (Habilitar el administrador de credenciales de Git) está desactivada. El administrador de credenciales de Git solo es compatible con CodeCommit si los usuarios de IAM configuran las credenciales de Git. Para obtener más información, consulte Para usuarios de HTTPS utilizando credenciales Git y Git para Windows: Instalé Git para Windows, pero me denegó el acceso a mi repositorio (403).

    nota

    Git es una plataforma en evolución que se actualiza periódicamente. En ocasiones, un cambio en una característica podría afectar a la forma en que trabaja CodeCommit. Si encuentra problemas con una versión específica de Git y CodeCommit, consulte la información de Solución de problemas.

CodeCommit admite la autenticación de HTTPS y SSH. Para completar la configuración, debe configurar credenciales de Git para CodeCommit (HTTPS, recomendado para la mayoría de los usuarios), un par de claves SSH (SSH) para usar al acceder CodeCommit, , git-remote-codecommit (recomendado para usuarios que utilizan acceso federado) o el auxiliar de credenciales incluido en el AWS CLI.

Paso 1. Crear un CodeCommit repositorio

En esta sección, utiliza el CodeCommit para crear la CodeCommit repositorio que utiliza para el resto de este tutorial. Para utilizar la AWS CLI para crear el repositorio, consulte Crear un repositorio de AWS CLI).

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

  2. En la selección de regiones, seleccione la región de AWS en la que desea crear el repositorio. Para obtener más información, consulte Variables de conexión de regiones y Git.

  3. En el Repositorios página, elegir Crear repositorio.

  4. En el Crear repositorio página, en Nombre del repositorio, introduzca un nombre para el repositorio.

    nota

    Los nombres de repositorio distinguen entre mayúsculas y minúsculas. El nombre debe ser único en el AWS Región para tu AWS cuenta.

  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 el marcado en la consola y acepta todos los caracteres HTML y todos los caracteres Unicode válidos. Si es un desarrollador de aplicaciones que utiliza las API de GetRepository o BatchGetRepositories y tiene previsto mostrar el campo de la descripción del repositorio en un navegador web, consulte la Referencia de la API de CodeCommit.

  6. (Opcional) Elegir Añadir etiqueta para añadir una o más etiquetas de repositorio (una etiqueta de atributo personalizada que le ayuda a organizar y gestionar su AWS recursos) a su repositorio. Para obtener más información, consulte Etiquetado de repositorios en AWS CodeCommit.

  7. (Opcional) Seleccionar Activar Amazon CodeGuru Reviewer para Java si este repositorio conteners Código Java, y desea CodeGuru Reviewer para analizar él mismo. CodeGuru Reviewer utiliza varios modelos de aprendizaje automático para encontrar defectos de código Java y sugerir mejoras y correcciones en solicitudes de extracción. Para obtener más información, consulte Guía del usuario de Amazon CodeGuru Reviewer.

  8. Elegir Crear.


                Creación de un repositorio para migrar contenido local a CodeCommit

Una vez creado, el repositorio aparece en el Repositorios. En la columna URL, seleccione el icono de copia y, a continuación, elija el protocolo (HTTPS o SSH) que se utiliza para conectar a CodeCommit. Copie la dirección URL.

Por ejemplo, si ha nombrado su repositorio MyFirstRepo y está utilizando HTTPS, la URL tendría el aspecto siguiente:

https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyFirstRepo

Necesita esta URL más adelante en Paso 2. Migrar contenido local a la CodeCommit repositorio.

Paso 2. Migrar contenido local a la CodeCommit repositorio

Ahora que tiene un repositorio de CodeCommit, puede elegir un directorio del equipo local para convertirlo en un repositorio de Git local. El comando git init se puede utilizar para convertir el contenido sin versión existente en un repositorio de Git o, si aún no dispone de archivos o contenido, para inicializar un nuevo repositorio vacío.

  1. En el terminal o en la línea de comandos del equipo local, cambie los directorios al directorio que desee utilizar como origen del repositorio.

  2. Ejecute el comando git init para inicializar el control de versiones de Git en el directorio. En la raíz del directorio se crea un subdirectorio .git que permite realizar un seguimiento del control de versiones. La carpeta .git también contiene todos los metadatos que necesita el repositorio.

    git init
  3. Añada los archivos que desea incluir en el control de versiones. En este tutorial, ejecuta el git add comando con el . especificador para agregar todos los archivos de este directorio. Para ver otras opciones, consulte la documentación de Git.

    git add .
  4. Cree una confirmación para añadir archivos con un mensaje de confirmación.

    git commit –m "Initial commit"
  5. Ejecutar el git push comando, especificando la URL y el nombre del destino CodeCommit y el repositorio --all. (Esta es la URL que copió en Paso 1. Crear un CodeCommit repositorio.)

    Por ejemplo, si ha nombrado su repositorio MyFirstRepo y está configurado para usar HTTPS, ejecutaría el siguiente comando:

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

Paso 3. Ver archivos en CodeCommit

Una vez que haya enviado el contenido del directorio, puede utilizar la consola de CodeCommit para ver rápidamente todos los archivos del repositorio.

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

  2. En Repositorios, elegir el nombre del repositorio (por ejemplo, MyFirstRepository) de la lista.

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

Paso 4. Compartir el CodeCommit repositorio

Al crear un repositorio en CodeCommit, se generan dos puntos de enlace: uno para conexiones HTTPS y otro para conexiones SSH. Ambas proporcionan conexiones seguras a través de una red. Los usuarios pueden utilizar cualquiera de los dos protocolos. Ambos puntos de enlace permanecen activos, independientemente del protocolo que recomiende a los usuarios. Antes de poder compartir sus repositorios con otros usuarios, debe crear políticas de IAM que permitan a otros usuarios acceder a su repositorio. Proporcione las instrucciones de acceso a sus usuarios.

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

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

  2. En el Tablero área de navegación, elegir Políticas, y luego elegir Crear política.

  3. En el Crear política página, elegir Importar política gestionada.

  4. En el Importar políticas gestionadas página, en Filtrar políticas, introducir AWSCodeCommitPowerUser. Seleccione el botón junto al nombre de la póliza y, a continuación, elija Importar.

  5. En el Crear política página, elegir JSON. Sustituya la parte "*" de la Resource línea para CodeCommit acciones con el nombre de recursos de Amazon (ARN) del CodeCommit repositorio, como se muestra aquí:

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

    Para encontrar el ARN para el CodeCommit repositorio, vaya al CodeCommit y seleccione el nombre del repositorio de la lista. Para obtener más información, consulte Ver detalles del repositorio.

    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, elija Política de revisión.

  6. En el Política de revisión página, en Nombreintroduzca un nombre nuevo para la política (por ejemplo, AWSCodeCommitPowerUser-MyDemoRepo). Proporcione opcionalmente una descripción de esta política.

  7. Elegir Crear política.

Para gestionar el acceso a su repositorio, cree un IAM grupo para sus usuarios, añadir IAM usuarios de ese grupo y, a continuación, adjuntar la política gestionada por el cliente que creó en el paso anterior. Asocie cualquier otra política necesaria para el acceso, como IAMSelfManageServiceSpecificCredentials o IAMUserSSHKeys.

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

  2. En el Tablero área de navegación, elegir Grupos, y luego elegir Crear nuevo grupo.

  3. En el Establecer nombre de grupo página, en Nombre del grupointroduzca un nombre para el grupo (por ejemplo, MyDemoRepoGroup), y luego elegir Siguiente paso. Tenga en cuenta la posibilidad de incluir el nombre del repositorio como parte del nombre del grupo.

    nota

    Este nombre debe ser único en un AWS cuenta.

  4. Seleccione la casilla situada junto a la política administrada por el cliente que haya creado en la sección anterior (por ejemplo, AWSCodeCommitPowerUser-MyDemoRepo).

  5. En el Revisión página, elegir Crear grupo. IAM crea este grupo con las políticas especificadas ya adjuntadas. El grupo aparece en la lista de grupos asociados a su AWS cuenta.

  6. Seleccione su grupo de la lista.

  7. En la página de resumen de grupo, seleccione la Usuarios y luego elegir Agregar usuarios al grupo. En la lista que muestra todos los usuarios asociados con su AWS cuenta, seleccione las casillas junto a los usuarios a los que desee permitir el acceso a la CodeCommit repositorio y, a continuación, elegir Añadir usuarios.

    sugerencia

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

  8. Cuando haya añadido a sus usuarios, cierre el IAM.

Después de haber creado un IAM usuario que se utilizará para acceder CodeCommit utilizando el grupo de políticas y las políticas configuradas, envíe ese usuario la información necesaria para conectarse al repositorio.

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

  2. En el selector de regiones, elija la región de AWS en la que se creó el repositorio. Cada región de AWS tiene sus propios repositorios. Para obtener más información, consulte Variables de conexión de regiones y Git.

  3. En el Repositorios seleccione el repositorio que desea compartir.

  4. En Clonar URL, seleccione el protocolo que desea que utilicen los usuarios. Esto copiará la URL de clonación del protocolo de conexión.

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