AWS CodeCommit
Guía del usuario
Versión de API 2015-04-13
AWS CodeCommit: Guía del usuario
Copyright © 2018 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.
Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any manner that is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by Amazon.
Table of Contents
¿Qué es AWS CodeCommit? ... 1
Presentación de AWS CodeCommit ... 1
¿Cómo funciona AWS CodeCommit? ... 2
¿En qué se diferencia AWS CodeCommit del control de versiones de archivos de Amazon S3? ... 3
¿Cómo empiezo a trabajar con AWS CodeCommit? ... 3
¿Dónde puedo encontrar más información sobre Git? ... 3
Configuración ... 4
Configuración mediante credenciales de Git ... 4
Configuración con otros métodos ... 4
Compatibilidad entre AWS CodeCommit, Git y otros componentes ... 5
Usuarios HTTPS mediante credenciales de Git ... 6
Paso 1: Configuración inicial de AWS CodeCommit ... 6
Paso 2: Instalar Git ... 7
Paso 3: Crear credenciales de Git para conexiones HTTPS al AWS CodeCommit ... 7
Paso 4: Conectarse a la consola de AWS CodeCommit y clonar el repositorio ... 9
Pasos siguientes ... 9
Para conexiones desde herramientas de desarrollo ... 10
Integración de AWS Cloud9 con AWS CodeCommit ... 13
Integración de Visual Studio con AWS CodeCommit ... 16
Integración de Eclipse con AWS CodeCommit ... 20
Usuarios de SSH que no utilizan la AWS CLI ... 25
Paso 1: Asociar la clave pública al usuario de IAM ... 26
Paso 2: Añadir AWS CodeCommit a la configuración de SSH ... 26
Pasos siguientes ... 27
Para conexiones SSH en Linux, macOS, or Unix ... 27
Paso 1: Configuración inicial de AWS CodeCommit ... 28
Paso 2: Instalar Git ... 28
Paso 3: Configurar credenciales en Linux, macOS, or Unix ... 29
Paso 4: Conectarse a la consola de AWS CodeCommit y clonar el repositorio ... 31
Pasos siguientes ... 32
Para conexiones SSH en Windows ... 32
Paso 1: Configuración inicial de AWS CodeCommit ... 32
Paso 2: Instalar Git ... 33
SSH y Windows: configuración de las claves públicas y privadas de Git y AWS CodeCommit ... 33
Paso 4: Conectarse a la consola de AWS CodeCommit y clonar el repositorio ... 35
Pasos siguientes ... 36
Para conexiones HTTPS en Linux, macOS, or Unix con el auxiliar de credenciales de la AWS CLI ... 36
Paso 1: Configuración inicial de AWS CodeCommit ... 37
Paso 2: Instalar Git ... 38
Paso 3: Configurar el auxiliar de credenciales ... 39
Paso 4: Conectarse a la consola de AWS CodeCommit y clonar el repositorio ... 40
Pasos siguientes ... 41
Para conexiones HTTPS en Windows con el auxiliar de credenciales de la AWS CLI ... 41
Paso 1: Configuración inicial de AWS CodeCommit ... 41
Paso 2: Instalar Git ... 43
Paso 3: Configurar el auxiliar de credenciales ... 44
Paso 4: Conectarse a la consola de AWS CodeCommit y clonar el repositorio ... 45
Pasos siguientes ... 46
Introducción ... 47
Tutorial sobre AWS CodeCommit ... 47
Paso 1: Crear un repositorio de AWS CodeCommit ... 48
Paso 2: Añadir archivos a su repositorio ... 49
Paso 3: Examinar el contenido del repositorio ... 51
Paso 4: Crear y colaborar en una solicitud de extracción ... 56
Paso 5: Siguientes pasos ... 61
Paso 6: Eliminación ... 61
Tutorial de Git con AWS CodeCommit ... 62
Paso 1: Crear un repositorio de AWS CodeCommit ... 62
Paso 2: Crear un repositorio local ... 63
Paso 3: Crear la primera confirmación ... 64
Paso 4: Enviar la primera confirmación ... 64
Paso 5: Compartir el repositorio de AWS CodeCommit y enviar y extraer otra confirmación ... 64
Paso 6: Crear y compartir una ramificación ... 66
Paso 7: Crear y compartir una etiqueta ... 67
Paso 8: Configurar los permisos de acceso ... 68
Paso 9: Eliminación ... 70
Integraciones de productos y servicios ... 72
Integración con otros servicios de AWS ... 72
Ejemplos de integración de la comunidad ... 76
Publicaciones de blog ... 76
Ejemplos de código ... 77
Trabajar con repositorios ... 79
Creación de un repositorio ... 80
Uso de la consola de AWS CodeCommit para crear un repositorio ... 80
Uso de la AWS CLI para crear un repositorio de AWS CodeCommit ... 81
Conectarse a un repositorio ... 82
Requisitos previos para la conexión a un repositorio de AWS CodeCommit ... 83
Conectarse al repositorio de AWS CodeCommit clonando el repositorio ... 83
Conectar un repositorio local al repositorio de AWS CodeCommit ... 84
Compartir un repositorio ... 85
Seleccione el protocolo de conexión para compartir con sus usuarios ... 86
Creación de políticas IAM para su repositorio ... 86
Creación de un grupo IAM para usuarios de repositorios ... 87
Compartir la información de conexión con los usuarios ... 88
Configuración de notificaciones para eventos del repositorio ... 89
Uso de notificaciones del repositorio ... 90
Configuración de notificaciones del repositorio ... 91
Cambio, habilitación o deshabilitación de notificaciones ... 93
Eliminación de la configuración de notificaciones de un repositorio ... 94
Administración de los disparadores de un repositorio ... 96
Creación del recurso e introducción de permisos para AWS CodeCommit ... 96
Creación de un disparador para un tema de Amazon SNS ... 97
Creación de un disparador para una función Lambda ... 102
Crear un disparador para una función Lambda existente ... 105
Edición de los disparadores de un repositorio ... 111
Prueba de disparadores para un repositorio ... 112
Eliminación de disparadores de un repositorio ... 114
Visualización de la información de los repositorios ... 116
Uso de la consola de AWS CodeCommit para ver la información de los repositorios ... 116
Uso de Git para ver la información de los repositorios de AWS CodeCommit ... 116
Uso de la AWS CLI para ver la información de los repositorios de AWS CodeCommit ... 117
Cambio de la configuración de los repositorios ... 120
Uso de la consola de AWS CodeCommit para cambiar la configuración del repositorio ... 120
Uso de la AWS CLI para cambiar la configuración de los repositorios de AWS CodeCommit ... 121
Sincronización de los cambios entre repositorios ... 123
Envío de confirmaciones a dos repositorios ... 124
Configuración de acceso entre cuentas a un repositorio ... 127
Acceso al repositorio entre cuentas: acciones del administrador de CuentaA ... 128
Acceso al repositorio entre cuentas: acciones del administrador de CuentaB ... 130
Acceso al repositorio entre cuentas: acciones del usuario del repositorio de CuentaB ... 132
Eliminar un repositorio ... 135
Versión de API 2015-04-13
Use la consola de AWS CodeCommit para eliminar un repositorio ... 136
Eliminar un repositorio local ... 136
Use la AWS CLI para eliminar un repositorio de AWS CodeCommit ... 136
Uso de archivos ... 138
Navegación de archivos en un repositorio ... 139
Navegación de un repositorio de AWS CodeCommit ... 139
Creación o adición de un archivo ... 140
Creación o carga de un archivo en la consola de AWS CodeCommit ... 141
Adición de un archivo con la AWS CLI ... 142
Adición de un archivo con Git ... 143
Edición del contenido de un archivo ... 143
Edición de un archivo en la consola de AWS CodeCommit ... 144
Edición de un archivo con la AWS CLI ... 145
Edición de un archivo con Git ... 143
Trabajo con solicitudes de extracción ... 147
Creación de una solicitud de extracción ... 151
Uso de la consola de AWS CodeCommit para crear una solicitud de extracción ... 151
Uso de la AWS CLI para crear una solicitud de extracción ... 153
Visualización de solicitudes de extracción ... 154
Uso de la consola de AWS CodeCommit para ver solicitudes de extracción ... 155
Uso de la AWS CLI para ver solicitudes de extracción ... 156
Revisión de una solicitud de extracción ... 158
Uso de la consola de AWS CodeCommit para revisar una solicitud de extracción ... 158
Uso de la AWS CLI para revisar solicitudes de extracción ... 162
Actualización de una solicitud de extracción ... 165
Uso de Git para actualizar una solicitud de extracción ... 166
Uso de la consola de AWS CodeCommit para actualizar una solicitud de extracción ... 167
Uso de la AWS CLI para actualizar solicitudes de extracción ... 167
Cierre de una solicitud de extracción ... 169
Uso de la consola de AWS CodeCommit para cerrar una solicitud de extracción ... 170
Uso de la AWS CLI para cerrar solicitudes de extracción ... 171
Uso de confirmaciones ... 173
Creación de una confirmación ... 174
Visualización de la información detallada de una confirmación ... 176
Examinación de confirmaciones de un repositorio ... 176
Uso de la AWS CLI para ver la información detallada de la confirmación ... 180
Uso de Git para ver información detallada de la confirmación ... 182
Comparación de confirmaciones ... 184
Comparación de una confirmación con su elemento primario ... 185
Comparación de dos especificadores de confirmación cualquiera ... 188
Comentario sobre una confirmación ... 190
Ver los comentarios de una confirmación en un repositorio ... 191
Añadir y responder a los comentarios de una confirmación en un repositorio ... 193
Utilizar la AWS CLI para ver, añadir, actualizar y responder a los comentarios ... 196
Crear una etiqueta ... 200
Uso de Git para crear una etiqueta ... 201
Visualización de información detallada de las etiquetas ... 201
Uso de la consola de AWS CodeCommit para ver la información detallada de la etiqueta ... 202
Uso de Git para ver la información detallada de las etiquetas ... 202
Eliminación de una etiqueta ... 204
Uso de Git para eliminar una etiqueta ... 204
Trabajo con ramificaciones ... 206
Creación de una ramificación ... 207
Utilice la consola de AWS CodeCommit para crear una ramificación. ... 207
Uso de Git para crear una ramificación ... 208
Uso de la AWS CLI para crear una ramificación ... 208
Visualización de la información detallada de la ramificación ... 209
Uso de la consola de AWS CodeCommit para ver la información detallada de la ramificación ... 210
Uso de Git para ver la información detallada de la ramificación ... 210
Uso de AWS CLI para ver la información detallada de la ramificación ... 211
Comparación de ramificaciones ... 212
Comparación de una ramificación y la ramificación predeterminada ... 213
Comparación de dos ramificaciones específicas ... 214
Cambiar la configuración de una ramificación ... 215
Uso de la consola de AWS CodeCommit para cambiar la ramificación predeterminada ... 215
Uso de la AWS CLI para cambiar la configuración de la ramificación ... 216
Eliminación de una ramificación ... 217
Uso de la consola de AWS CodeCommit para eliminar una ramificación ... 217
Uso de la AWS CLI para eliminar una ramificación ... 218
Utilización de Git para eliminar una ramificación ... 219
Trabajo con las preferencias del usuario ... 220
Ver y guardar las preferencias del usuario ... 220
Migración a AWS CodeCommit ... 223
Migración de un repositorio Git a AWS CodeCommit ... 223
Paso 0: Configuración necesaria para acceder a AWS CodeCommit ... 224
Paso 1: Crear un repositorio de AWS CodeCommit ... 227
Paso 2: Clonar el repositorio y enviarlo al repositorio de AWS CodeCommit ... 228
Paso 3: Ver archivos en AWS CodeCommit ... 229
Paso 4: Compartir el repositorio de AWS CodeCommit ... 230
Migración de contenido a AWS CodeCommit ... 232
Paso 0: Configuración necesaria para acceder a AWS CodeCommit ... 233
Paso 1: Crear un repositorio de AWS CodeCommit ... 236
Paso 2: Migrar contenido local al repositorio de AWS CodeCommit ... 237
Paso 3: Ver archivos en AWS CodeCommit ... 238
Paso 4: Compartir el repositorio de AWS CodeCommit ... 238
Migración de forma incremental de un repositorio ... 240
Paso 0: Determinar si realizar una migración de forma incremental ... 241
Paso 1: Instalar los requisitos previos y añadir el repositorio de AWS CodeCommit como remoto .. 241
Paso 2: Crear el script a utilizar para migrar de forma incremental ... 243
Paso 3: Ejecutar el script y migrar de forma incremental a AWS CodeCommit ... 243
Apéndice: script de muestra incremental-repo-migration.py ... 244
Solución de problemas ... 249
Solución de problemas de credenciales de Git (HTTPS) ... 249
Credenciales de Git para AWS CodeCommit: el sistema sigue solicitando las credenciales al conectarme a mi repositorio de AWS CodeCommit en el terminal o en la línea de comandos ... 249
Credenciales de Git para AWS CodeCommit: las credenciales de Git están configuradas, pero el sistema no las utiliza según lo previsto ... 250
Solución de problemas de conexiones SSH ... 250
Error de acceso: clave pública cargada correctamente en IAM pero error de conexión en los sistemas Linux, macOS, or Unix ... 251
Error de acceso: clave pública cargada correctamente en IAM y SSH probado con éxito pero la conexión devuelve un error en los sistemas Windows ... 251
Solicitud de verificación de autenticación: no se puede determinar la autenticidad del host al conectarse a un repositorio de AWS CodeCommit ... 252
Error de IAM: "Format no válido" al intentar añadir una clave pública en IAM ... 254
Git en Windows: el emulador de Bash o la línea de comandos se congela al intentar conectar mediante SSH ... 254
Solución de problemas del ayudante de credenciales (HTTPS) ... 255
Git para macOS: he configurado el auxiliar de credenciales correctamente, pero ahora no tengo acceso a mi repositorio (403) ... 255
Git para Windows: he instalado Git para Windows, pero no tengo permiso para acceder a mi repositorio (403) ... 257
Solución de problemas de clientes de Git ... 258
Versión de API 2015-04-13
Error de Git: error: error de RPC; resultado = 56, código HTTP = 200 grave: El extremo remoto
se ha interrumpido de forma inesperada ... 258
Error de Git: demasiados comandos de actualización de referencia ... 259
Error de Git: envío a través de HTTPS dividido en algunas versiones de Git ... 259
Error de Git: 'gnutls_handshake() failed' ... 259
Error de Git: Git no encuentra el repositorio de AWS CodeCommit o no tiene permiso para acceder al repositorio ... 259
Git en Windows: métodos de autenticación no admitidos disponibles (clave pública) ... 260
Solución de errores de acceso ... 260
Error de acceso: solicitud del nombre de usuario de AWS al conectarse a un repositorio de AWS CodeCommit ... 260
Error de acceso: solicitud del nombre de usuario y la contraseña al conectarse a un repositorio de AWS CodeCommit desde Windows ... 261
Error de acceso: clave pública denegada al conectarse a un repositorio de AWS CodeCommit ... 261
Solución de errores de configuración ... 261
Error de configuración: no se pueden configurar las credenciales de AWS CLI en macOS ... 262
Solución de problemas de errores de la consola ... 262
Error de acceso: acceso con clave de cifrado rechazado para un repositorio de AWS CodeCommit desde la consola o la AWS CLI ... 262
Error de consola: no se puede examinar el código en un repositorio de AWS CodeCommit desde la consola ... 262
Solución de problemas de disparadores ... 263
Error de disparador: el disparador del repositorio no se ejecuta cuando se espera ... 263
Activar la depuración ... 263
Autenticación y control de acceso ... 265
Autenticación ... 265
Control de acceso ... 266
Información general sobre la administración de acceso ... 267
Recursos y operaciones ... 267
Titularidad de los recursos ... 268
Administración del acceso a los recursos ... 268
Ámbito de aplicación de los recursos en AWS CodeCommit ... 270
Especificar elementos de políticas: recursos, acciones, efectos y entidades principales ... 270
Especificación de condiciones en una política ... 271
Usar políticas basadas en identidad (políticas de IAM) ... 271
Permisos necesarios para usar la consola de AWS CodeCommit ... 272
Políticas administradas (predefinidas) de AWS para AWS CodeCommit ... 274
Ejemplos de políticas administradas por el cliente ... 279
Referencia de permisos de AWS CodeCommit ... 283
Permisos obligatorios para comandos del cliente Git ... 284
Permisos para realizar acciones en ramificaciones ... 285
Permisos para realizar acciones en solicitudes de extracción ... 286
Permisos para realizar acciones en archivos individuales ... 288
Permisos para realizar acciones en comentarios ... 288
Permisos para realizar acciones en código confirmado ... 289
Permisos para realizar acciones en repositorios ... 291
Permisos para realizar acciones en disparadores ... 292
Permisos para realizar acciones en la integración de AWS CodePipeline ... 292
Información sobre AWS CodeCommit ... 294
Regiones y puntos de enlace de conexión de Git ... 294
Regiones compatibles con AWS CodeCommit ... 294
Puntos de enlace de conexión de Git ... 295
Huellas digitales del servidor para AWS CodeCommit ... 296
Límites ... 298
Acceso temporal ... 301
Paso 1: Completar los requisitos previos ... 302
Paso 2: Obtener las credenciales de acceso temporal ... 302
Paso 3: Configurar la AWS CLI con las credenciales de acceso temporal ... 302
Paso 4: Acceder a los repositorios de AWS CodeCommit ... 303
AWS KMS y cifrado ... 304
Contexto de cifrado ... 305
Registro de llamadas a la API de AWS CodeCommit con AWS CloudTrail ... 305
Información de AWS CodeCommit en CloudTrail ... 305
Definición de las entradas de archivos de registro de AWS CodeCommit ... 306
Referencia de la línea de comandos ... 311
Comandos básicos de Git ... 313
Variables de configuración ... 314
Repositorios remotos ... 314
Confirmaciones ... 315
Ramificaciones ... 316
Etiquetas ... 317
Historial de revisión ... 319
AWS Glossary ... 324
Versión de API 2015-04-13
Presentación de AWS CodeCommit
¿Qué es AWS CodeCommit?
AWS CodeCommit es un servicio de control de versiones alojado en Amazon Web Services que puede utilizar para almacenar y gestionar recursos de forma privada (como documentos, código fuente y archivos binarios) en la nube. Para obtener más información sobre los precios de AWS CodeCommit, consulte Precios.
Temas
• Presentación de AWS CodeCommit (p. 1)
• ¿Cómo funciona AWS CodeCommit? (p. 2)
• ¿En qué se diferencia AWS CodeCommit del control de versiones de archivos de Amazon S3? (p. 3)
• ¿Cómo empiezo a trabajar con AWS CodeCommit? (p. 3)
• ¿Dónde puedo encontrar más información sobre Git? (p. 3)
Presentación de AWS CodeCommit
AWS CodeCommit es un servicio de control de código fuente administrado, seguro y altamente escalable que aloja repositorios Git privados. AWS CodeCommit elimina la necesidad de gestionar un sistema propio de control de código fuente o de preocuparse acerca de la adaptación de su infraestructura. Puede utilizar AWS CodeCommit para almacenar cualquier elemento, desde código a archivos binarios. Además, es compatible con las funciones estándar de Git, por lo que funciona perfectamente con las herramientas existentes basadas en Git.
Con AWS CodeCommit puede:
• Beneficiarse de un servicio totalmente administrado alojado en AWS. AWS CodeCommit ofrece alta disponibilidad y durabilidad de servicio y elimina los gastos administrativos de gestión de su propio hardware y software. No es necesario aprovisionar ni escalar hardware, ni instalar, configurar y actualizar software de servidor.
• Almacenar su código de forma segura. Los repositorios de AWS CodeCommit se cifran tanto en reposo como en tránsito.
• Trabajar de forma colaborativa con el código. Los repositorios de AWS CodeCommit admiten solicitudes de extracción, donde los usuarios pueden revisar y realizar comentarios sobre los cambios de código de otros usuarios antes de combinarlos en ramificaciones; y notificaciones que se envían automáticamente por correo electrónicos a los usuarios sobre las solicitudes de extracción y los comentarios, y mucho más.
• Escalado sencillo de sus proyectos de control de versiones. Los repositorios de AWS CodeCommit pueden escalarse en vertical para cubrir sus necesidades de desarrollo. El servicio puede gestionar repositorios con un gran número de archivos o ramificaciones, archivos de gran tamaño e historiales de revisión largos.
• Almacenar todo y en cualquier momento. AWS CodeCommit no tiene límite respecto al tamaño de los repositorios ni los tipos de archivos que se pueden almacenar.
• Integrarse con otros servicios de AWS y de terceros. AWS CodeCommit mantiene los repositorios cerca de los demás recursos de producción en la nube de AWS, lo que ayuda a aumentar la velocidad y la frecuencia del ciclo de vida de desarrollo. Se integra con IAM y se puede utilizar con otros servicios de AWS y en paralelo con otros repositorios. Para obtener más información, consulte Integraciones de productos y servicios con AWS CodeCommit (p. 72).
¿Cómo funciona AWS CodeCommit?
• Migrar fácilmente archivos desde otros repositorios remotos. Puede migrar a AWS CodeCommit desde cualquier repositorio basado en Git.
• Usar las herramientas Git que ya conoce. AWS CodeCommit admite los comandos de Git, así como sus propios comandos de AWS CLI y las API.
¿Cómo funciona AWS CodeCommit?
AWS CodeCommit les resultará familiar a los usuarios de repositorios basados en Git, pero incluso aquellos que los desconozcan deberían encontrar la transición a AWS CodeCommit relativamente sencilla.
AWS CodeCommit proporciona una consola para la creación fácil de repositorios y la elaboración de listas de los repositorios y ramificaciones existentes. En unos sencillos pasos, los usuarios pueden encontrar información acerca de un repositorio y clonarlo en su equipo, creando un repositorio local en el que pueden realizar cambios y, a continuación, enviarlos al repositorio de AWS CodeCommit. Los usuarios pueden trabajar desde la línea de comandos en sus máquinas locales o utilizar un editor basado en GUI.
En la siguiente figura se muestra cómo utilizar el equipo de desarrollo, la AWS CLI o la consola de AWS CodeCommit y el servicio de AWS CodeCommit para crear y gestionar repositorios:
1. Uso de la AWS CLI o la consola de AWS CodeCommit para crear un Repositorio de AWS CodeCommit
2. Desde el equipo de desarrollo, use Git para ejecutar git clone y especifique el nombre del repositorio de AWS CodeCommit. Se crea un repositorio local que conecta con el Repositorio de AWS
CodeCommit.
3. Utilice el repositorio local en su equipo de desarrollo para modificar (añadir, editar y eliminar) archivos y, a continuación, ejecute git add para almacenar los archivos modificados localmente. Ejecute git commit para confirmar los archivos localmente y, a continuación, ejecute git push para enviar los archivos al Repositorio de AWS CodeCommit.
Versión de API 2015-04-13
¿En qué se diferencia AWS CodeCommit del control de versiones de archivos de Amazon S3?
4. Descargue los cambios de otros usuarios. Ejecute git pull para sincronizar los archivos en el
Repositorio de AWS CodeCommit con su repositorio local. De este modo, se asegura de que trabaja con la versión más reciente de los archivos.
Puede utilizar la AWS CLI o la consola de AWS CodeCommit para realizar un seguimiento y gestionar los repositorios.
¿En qué se diferencia AWS CodeCommit del
control de versiones de archivos de Amazon S3?
AWS CodeCommit se ha diseñado para el desarrollo de software en equipo. Gestiona lotes de cambios en varios archivos, cosa que puede realizarse en paralelo con los cambios realizados por otros
desarrolladores. El control de versiones de Amazon S3 admite la recuperación de versiones pasadas de archivos, pero no se centra en las características de seguimiento de archivos colaborativas que necesitan los equipos de desarrollo de software.
¿Cómo empiezo a trabajar con AWS CodeCommit?
Para empezar a trabajar con AWS CodeCommit:
1. Siga los pasos que se detallan en Configuración (p. 4) para preparar los equipos de desarrollo.
2. Siga los pasos que se detallan en uno o más de los tutoriales de Introducción (p. 47).
3. Cree (p. 80) proyectos de control de versiones en AWS CodeCommit o migre (p. 223) proyectos de control de versiones a AWS CodeCommit.
¿Dónde puedo encontrar más información sobre Git?
Si no conoce Git todavía, debe aprender a utilizar Git (p. 313). A continuación encontrará algunos recursos útiles:
• Pro Git es una versión online del libro Pro Git escrito por Scott Chacon y publicado por Apress.
• Git Immersion es una visita guiada interactiva que muestra los conceptos básicos de trabajar con Git publicada por Neo Innovation, Inc.
• Git Reference es una referencia rápida online que también puede usarse como tutorial en profundidad sobre Git publicado por el equipo de GitHub.
• Git Cheat Sheet incluye la sintaxis de comandos de Git básicos publicado por el equipo de GitHub.
• Git Pocket Guide escrita por Richard E. Silverman. Publicada por O'Reilly Media, Inc.
Configuración mediante credenciales de Git
Configuración para AWS CodeCommit
Puede iniciar sesión en la Consola de administración de AWS y cargar, añadir o editar un
archivo (p. 138) en un repositorio directamente desde la consola de AWS CodeCommit. Se trata de una forma rápida de realizar un cambio. Sin embargo, si desea trabajar con varios archivos, archivos en todas las ramificaciones, etc., considere la posibilidad de configurar su equipo local para trabajar con repositorios. La configuración más sencilla de AWS CodeCommit consiste en definir las credenciales de Git HTTPS para AWS CodeCommit. Este método de autenticación HTTPS:
• Utiliza un nombre de usuario y contraseña estáticas
• Funciona con todos los sistemas operativos compatibles con AWS CodeCommit
• También es compatible con entornos de desarrollo integrado (IDE) y otras herramientas de desarrollo que admiten las credenciales de Git
Puede utilizar otros métodos si no desea o no puede utilizar credenciales de Git por razones operativas.
Lea las siguientes otras opciones detenidamente para decidir qué método alternativo se adapta mejor a sus necesidades.
• Configuración mediante credenciales de Git (p. 4)
• Configuración con otros métodos (p. 4)
• Compatibilidad entre AWS CodeCommit, Git y otros componentes (p. 5)
Configuración mediante credenciales de Git
Con conexiones HTTPS y credenciales de Git, puede generar un nombre de usuario y contraseña estáticos en IAM. Seguidamente, puede utilizar estas credenciales con Git y cualquier herramienta de terceros que admita la autenticación con nombre de usuario y contraseña de Git. Este método es compatible con la mayoría de IDE y herramientas de desarrollo. Es el método de conexión más fácil y sencillo para AWS CodeCommit.
• Usuarios HTTPS mediante credenciales de Git (p. 6): siga estas instrucciones para establecer
conexiones entre su equipo local y los repositorios de AWS CodeCommit utilizando credenciales de Git.
• Para conexiones desde herramientas de desarrollo (p. 10): siga estas instrucciones para establecer conexiones entre su IDE u otras herramientas de desarrollo y los repositorios de AWS CodeCommit utilizando credenciales de Git. Los IDE que admiten las credenciales de Git son, entre otros, Visual Studio, Eclipse, Xcode e IntelliJ.
Configuración con otros métodos
Puede usar el protocolo SSH en lugar de HTTPS para conectarse a su repositorio de AWS CodeCommit.
Con conexiones SSH, debe crear archivos de claves públicas y privadas en su equipo local que Git y AWS CodeCommit utilizarán para la autenticación SSH. Puede asociar la clave pública con su usuario de IAM. Puede almacenar la clave privada en su equipo local. Dado que SSH requiere la creación y gestión manual de archivos de claves públicas y privadas, es posible que las credenciales de Git sean más fáciles y sencillas de utilizar con AWS CodeCommit.
Versión de API 2015-04-13
Compatibilidad entre AWS CodeCommit, Git y otros componentes
A diferencia de las credenciales de Git, la configuración de la conexión SSH variará en función del sistema operativo de su equipo local.
• Usuarios de SSH que no utilizan la AWS CLI (p. 25): siga estas instrucciones abreviadas si ya dispone de un par de claves pública y privada y conoce las conexiones SSH de su equipo local.
• Para conexiones SSH en Linux, macOS, or Unix (p. 27): siga estas instrucciones para obtener una explicación detallada sobre el proceso de creación de un par de claves pública y privada y sobre la configuración de conexiones en sistemas operativos Linux, macOS, or Unix.
• Para conexiones SSH en Windows (p. 32): siga estas instrucciones para obtener una explicación detallada sobre el proceso de creación de un par de claves pública y privada y sobre la configuración de conexiones en sistemas operativos Windows.
Si se conecta a AWS CodeCommit y AWS mediante un acceso federado o credenciales temporales, o si no desea configurar usuarios de IAM, puede definir conexiones a los repositorios de AWS CodeCommit utilizando el auxiliar de credenciales incluido en la AWS CLI. El auxiliar de credenciales permite que Git use HTTPS y una versión con firma criptográfica de sus credenciales de usuario de IAM o del rol de la instancia de Amazon EC2 cada vez que Git requiera autenticación en AWS para interactuar con los repositorios de AWS CodeCommit. Este es el único método de conexión para los repositorios de AWS CodeCommit que no requiere un usuario de IAM, por lo que es el único método compatible con el acceso federado y las credenciales temporales. Algunos sistemas operativos y versiones de Git disponen de sus propios auxiliares de credenciales, que son incompatibles con los auxiliares incluidos en la AWS CLI pues pueden provocar problemas de conectividad en AWS CodeCommit. Para que sea más sencillo, plantéese la opción de crear usuarios de IAM y configurar las credenciales de Git con conexiones HTTPS en lugar de utilizar el auxiliar de credenciales.
• Para conexiones HTTPS en Linux, macOS, or Unix con el auxiliar de credenciales de la AWS
CLI (p. 36): siga estas instrucciones para obtener una explicación detallada del proceso de instalación y configuración del auxiliar de credenciales en sistemas Linux, macOS, or Unix.
• Para conexiones HTTPS en Windows con el auxiliar de credenciales de la AWS CLI (p. 41): siga estas instrucciones para obtener una explicación detallada del proceso de instalación y configuración del auxiliar de credenciales en sistemas Windows.
Si se conecta a un repositorio de AWS CodeCommit que se hospeda en otra cuenta de AWS, puede configurar el acceso y las conexiones mediante funciones, políticas y el auxiliar de credenciales incluido en la AWS CLI.
• Configuración de acceso entre cuentas a un repositorio de AWS CodeCommit (p. 127): siga estas instrucciones para obtener una explicación detallada del proceso de configuración del acceso entre cuentas en una cuenta de AWS a los usuarios de un grupo de IAM en otra cuenta de AWS.
Compatibilidad entre AWS CodeCommit, Git y otros componentes
Al trabajar con AWS CodeCommit, utilizará Git. Y es posible que utilice otros programas. La siguiente tabla incluye la lista actualizada de compatibilidades de versiones.
Información de compatibilidad de versiones de AWS CodeCommit
Componente Version
Git AWS CodeCommit admite Git versión 1.7.9 y
posteriores.
Usuarios HTTPS mediante credenciales de Git
Componente Version
Curl AWS CodeCommit requiere curl 7.33 y versiones
posteriores. Sin embargo, existe un problema conocido con la actualización de HTTPS y Curl a 7.41.0. Para obtener más información, consulte Solución de problemas (p. 249).
Configuración de usuarios HTTPS mediante credenciales de Git
La forma más sencilla de configurar conexiones a los repositorios de AWS CodeCommit es configurar las credenciales de Git de AWS CodeCommit en la consola de IAM y, a continuación, utilizar esas credenciales en las conexiones HTTPS. También puede utilizar estas credenciales en cualquier herramienta de terceros o entorno de desarrollo individual (IDE) compatible con la autenticación HTTPS mediante un nombre de usuario y contraseña estáticos. Para ver ejemplos, consulte Para conexiones desde herramientas de desarrollo (p. 10).
Note
Si ya ha configurado el equipo local para utilizar el auxiliar de credenciales de AWS CodeCommit, debe editar el archivo .gitconfig para eliminar la información del auxiliar de credenciales antes de utilizar las credenciales de Git. Si el equipo local ejecuta macOS, es posible que deba borrar las credenciales de Keychain Access almacenadas en caché.
Paso 1: Configuración inicial de AWS CodeCommit
Siga estos pasos para configurar una cuenta de AWS, crear un usuario de IAM y configurar el acceso a AWS CodeCommit.
Para crear y configurar un usuario IAM para acceder a AWS CodeCommit 1. Cree una cuenta de AWS. Para ello, vaya a http://aws.amazon.com y elija Sign Up.
2. Cree un usuario IAM o use uno existente en su cuenta de AWS. Asegúrese de que tiene un ID de clave de acceso y una clave de acceso secreta asociados a ese usuario IAM. Para obtener más información, consulte Creación de un usuario IAM en su cuenta de AWS.
Note
AWS CodeCommit requiere AWS Key Management Service. Si está usando un usuario IAM existente, asegúrese de que no haya directivas adjuntas al usuario que denieguen expresamente las acciones AWS KMS requeridas por AWS CodeCommit. Para obtener más información, consulte AWS KMS y cifrado (p. 304).
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 la consola de IAM, en el panel de navegación, seleccione Users y, a continuación haga clic en el usuario IAM que desee configurar para el acceso a AWS CodeCommit.
5. En la pestaña Permissions, seleccione Add Permissions.
6. En Grant permissions, elija Attach existing policies directly.
7. Seleccione AWSCodeCommitFullAccess en la lista de políticas u otra política administrada para el acceso a AWS CodeCommit. Para obtener más información sobre las políticas administradas
Versión de API 2015-04-13
Paso 2: Instalar Git
para AWS CodeCommit, consulte Políticas administradas (predefinidas) de AWS para AWS CodeCommit (p. 274).
Una vez que haya seleccionado la política que desee asociar, seleccione Next: Review para revisar la lista de políticas que se asociarán al usuario de IAM. Si la lista es correcta, seleccione Add permissions.
Para obtener más información sobre las políticas administradas de AWS CodeCommit y compartir el acceso a los repositorios con otros grupos y usuarios, consulte Compartir un repositorio (p. 85) y Autenticación y control de acceso de AWS CodeCommit (p. 265).
Si desea utilizar los comandos de la AWS CLI en AWS CodeCommit, instale la AWS CLI. Para obtener más información, consulte Referencia de la línea de comandos (p. 311).
Paso 2: Instalar Git
Para trabajar con archivos, validaciones y otra información en los repositorios de AWS CodeCommit deberá instalar Git en su máquina local. AWS CodeCommit admite Git versión 1.7.9 y posteriores.
Para instalar Git, le recomendamos sitios web como Git Downloads.
Note
Git es una plataforma en evolución que se actualiza periódicamente. Ocasionalmente, un cambio en una característica podría afectar a la forma en que funciona con AWS CodeCommit.
Si encuentra problemas con una versión específica de Git y AWS CodeCommit, consulte la información de Solución de problemas (p. 249).
Paso 3: Crear credenciales de Git para conexiones HTTPS al AWS CodeCommit
Después de instalar Git, cree credenciales de Git para el usuario de IAM en IAM. Para obtener más información, consulte Use Git Credentials and HTTPS with AWS CodeCommit en la IAM User Guide.
Para configurar HTTPS de Git HTTPS para AWS CodeCommit
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/.
Asegúrese de iniciar sesión como el usuario de IAM que va a crear y utilizar las credenciales de Git para las conexiones a AWS CodeCommit.
2. En el panel de navegación de la consola de IAM, elija Users y, en la lista de usuarios seleccione su usuario de IAM.
3. En la página de detalles del usuario, elija la Security Credentials y en HTTPS Git credentials for AWS CodeCommit, elija Generate.
Paso 3: Crear credenciales de Git para conexiones HTTPS al AWS CodeCommit
Note
No puede elegir su propio nombre de usuario o contraseña para las credenciales de Git. Para obtener más información, consulte Use Git Credentials and HTTPS with AWS CodeCommit.
4. Copie el nombre de usuario y la contraseña que IAM ha generado para usted (puede mostrar, copiar y pegar la información en un archivo seguro en el equipo local), o elija Download credentials para descargar la información en un archivo .CSV. Necesitará esta información para conectarse a AWS CodeCommit.
Una vez que haya guardado las credenciales, elija Cerrar.
Important
Esta es la única oportunidad de guardar el nombre de usuario y la contraseña. Si no lo hace, podrá copiar el nombre de usuario de la consola de IAM, pero no podrá buscar la contraseña.
Deberá restablecer la contraseña y, a continuación, guardarla.
Versión de API 2015-04-13
Paso 4: Conectarse a la consola de AWS CodeCommit y clonar el repositorio
Paso 4: Conectarse a la consola de AWS CodeCommit y clonar el repositorio
Si un administrador ya le ha enviado el nombre y los detalles de conexión del repositorio de AWS CodeCommit, puede omitir este paso y clonar el repositorio directamente.
Conexión a un repositorio de AWS CodeCommit
1. Abra la consola de AWS CodeCommit en https://console.aws.amazon.com/codecommit.
2. En el selector de regiones, seleccione la región en la que se creó el repositorio. Los repositorios son específicos de una región de AWS. Para obtener más información, consulte Regiones y puntos de enlace de conexión de Git (p. 294).
3. Seleccione de la lista el repositorio con el que desea establecer la conexión. Se abrirá la página Code para ese repositorio.
Si ve una página Welcome en lugar de la lista de repositorios, no existen repositorios asociados a su cuenta de AWS. Para crear un repositorio, consulte the section called “Creación de un repositorio” (p. 80) o siga los pasos del tutorial Tutorial de Git con AWS CodeCommit (p. 62).
4. Elija Connect. Revise las instrucciones y copie la URL que se debe utilizar para conectarse al repositorio.
5. Abra un terminal, una línea de comandos o un shell de Git. Con la URL HTTPS que ha copiado, ejecute el git clone para clonar el repositorio. Por ejemplo, para clonar un repositorio denominado MyDemoRepo en un repositorio local llamado my-demo-repo en la región EE.UU. Este (Ohio):
git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo- repo
La primera vez que se conecte, se le pedirá que introduzca el nombre de usuario y la contraseña del repositorio. Según la configuración del equipo local, este mensaje se enviará desde el sistema de gestión de credenciales del sistema operativo (por ejemplo, Keychain Access en el caso de macOS), la utilidad de administración de credenciales de la versión de Git (por ejemplo, el Administrador de credenciales de Git de Windows), el IDE o Git. Introduzca el nombre de usuario y la contraseña de las credenciales de Git que generó en IAM (las que creó en Paso 3: Crear credenciales de Git para conexiones HTTPS al AWS CodeCommit (p. 7)). En función del sistema operativo y otro software, esta información puede guardarse en un almacén de credenciales o en la utilidad de Administración de credenciales. Si se guarda, esta información no se le volverá a pedir a menos que cambie la contraseña, inactive las credenciales de Git o elimine las credenciales de Git en IAM.
Si el equipo local no tiene configurado un almacén de credenciales o una utilidad de Administración de credenciales, puede instalar uno. Para obtener más información sobre Git y cómo gestiona las credenciales, consulte Almacenamiento de credenciales en la documentación de Git.
Para obtener más información, consulte Conectarse al repositorio de AWS CodeCommit clonando el repositorio (p. 83) y Creación de una confirmación (p. 174).
Pasos siguientes
Ha completado los requisitos previos. Siga los pasos de Tutorial sobre AWS CodeCommit (p. 47) para empezar a utilizar AWS CodeCommit.
Para conexiones desde herramientas de desarrollo
Configuración de conexiones desde herramientas de desarrollo mediante credenciales de Git
Una vez que haya configurado las credenciales de Git de AWS CodeCommit en la consola de IAM, puede utilizar dichas credenciales en cualquier herramienta de desarrollo compatible con las credenciales de Git. Por ejemplo, puede configurar el acceso al repositorio de AWS CodeCommit en AWS Cloud9, Visual Studio, Eclipse, Xcode, IntelliJ o cualquier entorno de desarrollo integrado (IDE) que integre las credenciales de Git. Una vez que haya configurado el acceso, puede editar el código, confirmar los cambios y enviarlos directamente desde el IDE o cualquier otra herramienta de desarrollo.
Temas
• Integración de AWS Cloud9 con AWS CodeCommit (p. 13)
• Integración de Visual Studio con AWS CodeCommit (p. 16)
• Integración de Eclipse con AWS CodeCommit (p. 20)
Cuando el IDE o la herramienta de desarrollo le pida el nombre de usuario y la contraseña utilizados para conectarse al repositorio de AWS CodeCommit, introduzca las credenciales de Git para User name y Password que creó en IAM. Por ejemplo, si se le pide un nombre de usuario y una contraseña en Eclipse, debería introducir las credenciales de Git como se indica a continuación:
Para obtener más información sobre de las regiones y puntos de enlace de AWS CodeCommit, consulte Regiones y puntos de enlace de conexión de Git (p. 294).
También se le puede pedir que almacene el nombre de usuario y la contraseña desde el sistema operativo.
Por ejemplo, en Windows, debería introducir las credenciales de Git de la siguiente forma:
Versión de API 2015-04-13
Para conexiones desde herramientas de desarrollo
Para obtener más información sobre la configuración de las credenciales de Git para un determinado programa o herramienta de desarrollo de software, consulte la documentación del producto.
A continuación, no se ofrece una lista completa de IDE. AWS no se hace responsable del contenido de cualquiera de estos temas. Los enlaces se proporcionan únicamente para ayudarle a obtener más información sobre estas herramientas.
• AWS Cloud9 (p. 13)
• Visual Studio
De forma alternativa, instale el AWS Toolkit for Visual Studio. Para obtener más información, consulte Integración de Visual Studio con AWS CodeCommit (p. 16).
Para conexiones desde herramientas de desarrollo
• EGit con Eclipse
De forma alternativa, instale el AWS Toolkit for Eclipse. Para obtener más información, consulte Integración de Eclipse con AWS CodeCommit (p. 20).
• IntelliJ
Versión de API 2015-04-13
Integración de AWS Cloud9 con AWS CodeCommit
• XCode
Integración de AWS Cloud9 con AWS CodeCommit
Puede utilizar AWS Cloud9 para realizar cambios en el código de un repositorio de AWS CodeCommit.
AWS Cloud9 contiene una colección de herramientas que se utilizan para escribir código, así como para compilar, ejecutar, probar, depurar y publicar software. Entre otras cosas, puede clonar repositorios existentes, crear repositorios, y confirmar y enviar cambios en el código a un repositorio, todo ello desde el entorno de desarrollo EC2 de AWS Cloud9. El entorno de desarrollo EC2 de AWS Cloud9 suele estar preconfigurado con la AWS CLI, un rol de Amazon EC2 y Git, por lo que, en la mayoría de los casos, puede ejecutar unos cuantos comandos sencillos y comenzar a interactuar con el repositorio.
Para utilizar AWS Cloud9 con AWS CodeCommit, necesita lo siguiente:
• Un entorno de desarrollo EC2 de AWS Cloud9 que se ejecute en Amazon Linux.
• El IDE de AWS Cloud9 abierto en un navegador web.
• Un usuario de IAM que tenga aplicada una de las políticas administradas de AWS CodeCommit y una de las políticas administradas de AWS Cloud9.
Para obtener más información, consulte Políticas administradas (predefinidas) de AWS para AWS CodeCommit (p. 274) y Descripción y obtención de las credenciales de seguridad.
Temas
• Paso 1: Creación de un entorno de desarrollo de AWS Cloud9 (p. 13)
• Paso 2: Configuración del auxiliar de credenciales de la AWS CLI en el entorno de desarrollo EC2 de AWS Cloud9 (p. 15)
• Paso 3: Clonación de un repositorio de AWS CodeCommit en el entorno de desarrollo EC2 de AWS Cloud9 (p. 15)
• Pasos siguientes (p. 16)
Paso 1: Creación de un entorno de desarrollo de AWS Cloud9
AWS Cloud9 alojará el entorno de desarrollo en una instancia de Amazon EC2. Esta es la forma más sencilla de realizar la integración, ya que puede utilizar las credenciales administradas temporales de AWS para que la instancia se conecte al repositorio de AWS CodeCommit. Si desea utilizar su propio servidor en su lugar, consulte la AWS Cloud9 User Guide.
Integración de AWS Cloud9 con AWS CodeCommit
Para crear un entorno de AWS Cloud9, realice los siguientes pasos:
1. Inicie sesión en AWS con el usuario de IAM que ha configurado y abra la consola de AWS Cloud9.
2. En la consola de AWS Cloud9, elija Create environment.
3. En Step 1: Name environment, escriba un nombre para el entorno de desarrollo en Name. Si lo desea, añada una descripción para el entorno y, a continuación, elija Next Step.
4. En Step 2: Configure Settings, configure el entorno como se indica a continuación:
• En Environment type, elija Create a new instance for environment (EC2).
• En Instance type, elija el tipo de instancia adecuado para su entorno de desarrollo. Por ejemplo, si solo está explorando el servicio, puede elegir la opción predeterminada, t2.micro. Si va a utilizar este entorno para trabajos de desarrollo, elija un tipo de instancia más grande.
• Acepte las demás opciones de configuración predeterminadas, a menos que tenga razones específicas para cambiarlas (por ejemplo, si su organización utiliza una VPC específica o si su cuenta de AWS no tiene ninguna VPC configurada) y, a continuación, elija Next step.
5. En Step 3: Review, revise la configuración. Si necesita realizar cambios, elija Previous step. En caso contrario, elija Create environment.
Se tardan varios minutos en crear un entorno y conectarse a él por primera vez. Si le parece que tarda demasiado, consulte Troubleshooting en la Guía del usuario de AWS Cloud9.
6. Cuando esté conectado a su entorno, ejecute el comando git --versión en la ventana de terminal para comprobar si Git ya está instalado y es una versión compatible.
Si Git no está instalado, o si no es una versión compatible, instale una versión compatible. AWS CodeCommit admite Git versión 1.7.9 y posteriores. Para instalar Git, le recomendamos sitios web como Git Downloads.
Tip
En función del sistema operativo de su entorno, es posible que pueda utilizar el comando yum con la opción sudo para instalar actualizaciones, incluida Git. Por ejemplo, una secuencia de comandos administrativos podría ser como los tres comandos siguientes:
sudo yum -y update sudo yum -y install git git --version
7. Configure el nombre de usuario y el correo electrónico que se van a asociar a sus comandos Git ejecutando el comando git config. Por ejemplo:
Versión de API 2015-04-13
Integración de AWS Cloud9 con AWS CodeCommit
git config --global user.name "Mary Major"
git config --global user.email [email protected]
Paso 2: Configuración del auxiliar de credenciales de la AWS CLI en el entorno de desarrollo EC2 de AWS Cloud9
Una vez que haya creado un entorno de AWS Cloud9, puede configurar el auxiliar de credenciales de la AWS CLI para administrar las credenciales para las conexiones con el repositorio de AWS CodeCommit. El entorno de desarrollo de AWS Cloud9 incluye credenciales administradas temporales de AWS que están asociados a su usuario de IAM. Utilizará estas credenciales con el auxiliar de credenciales de la AWS CLI.
1. Abra la ventana de terminal y escriba el siguiente comando para comprobar que la AWS CLI está instalada:
aws --version
Si se ejecuta correctamente, este comando devuelve la versión de la AWS CLI instalada actualmente.
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. En el terminal, escriba los siguientes comandos para configurar el auxiliar de credenciales de la AWS CLI para las conexiones HTTPS:
git config --global credential.helper '!aws codecommit credential-helper $@' git config --global credential.UseHttpPath true
Tip
El auxiliar de credenciales utilizará el rol predeterminado de la instancia de Amazon EC2 para el entorno de desarrollo. Si va a utilizar el entorno de desarrollo para conectarse a repositorios que no están alojados en AWS CodeCommit, configure conexiones SSH a dichos repositorios o configure un archivo .gitconfig local para utilizarlo como sistema de administración de credenciales alternativo al conectarse a esos otros repositorios. Para obtener más información, consulte Git Tools - Credential Storage en el sitio web de Git.
Paso 3: Clonación de un repositorio de AWS CodeCommit en el entorno de desarrollo EC2 de AWS Cloud9
Una vez que haya configurado el auxiliar de credenciales de la AWS CLI, puede clonar el repositorio de AWS CodeCommit en él. A continuación, puede comenzar a trabajar con el código.
1. En el terminal, ejecute el comando git clone, especificando la URL HTTPS de clonación del repositorio que desea clonar. Por ejemplo, si desea clonar un repositorio denominado MyDemoRepo en la región EE.UU. Este (Ohio), escriba:
git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo
Tip
Puede encontrar la URL de clonación del repositorio en la consola de AWS CodeCommit, tanto en el panel Dashboard como en la sección Connect de la página Code del repositorio.
Integración de Visual Studio con AWS CodeCommit
2. Cuando haya finalizado la clonación, expanda la carpeta del repositorio en el panel de navegación lateral, y elija el archivo que desea abrir para editarlo. También puede elegir File seguido de New File para crear un archivo nuevo.
3. Cuando haya terminado de editar o crear archivos, en la ventana de terminal, desplácese al directorio que contiene el repositorio clonado y, a continuación, confirme y envíe los cambios. Por ejemplo, si añade un archivo nuevo denominado MyFile.py:
cd MyDemoRepo
git commit -a MyFile.py
git commit -m "Added a new file with some code improvements"
git push
Pasos siguientes
Para obtener más información sobre cómo usar AWS Cloud9, consulte la Guía del usuario de AWS Cloud9. Para obtener más información sobre cómo usar Git con AWS CodeCommit, consulte Tutorial de Git con AWS CodeCommit (p. 62).
Integración de Visual Studio con AWS CodeCommit
Puede utilizar Visual Studio para realizar cambios en el código en un repositorio de AWS CodeCommit.
AWS Toolkit for Visual Studio incluye ahora características que hacen más fácil y cómodo el uso de AWS CodeCommit cuando se trabaja desde Visual Studio Team Explorer. La integración con Toolkit for Visual Studio está diseñada para funcionar con credenciales de Git y un usuario de IAM. Puede clonar repositorios existentes, crear repositorios, confirmar y enviar cambios en el código a un repositorio y mucho más.
Versión de API 2015-04-13
Integración de Visual Studio con AWS CodeCommit
Important
Toolkit for Visual Studio solo está disponible para su instalación en los sistemas operativos de Windows.
Si ha utilizado Toolkit for Visual Studio antes, probablemente ya esté familiarizado con la configuración de perfiles de credenciales de AWS que contienen una clave de acceso y una clave secreta. Estos perfiles de credenciales se usan en Toolkit for Visual Studio para habilitar las llamadas a las API de servicio de AWS (por ejemplo, en Amazon S3 para obtener una lista de los buckets o en AWS CodeCommit para obtener una lista de repositorios). Para extraer y enviar un código a un repositorio de AWS CodeCommit, también se necesitan credenciales de Git. Si no dispone de credenciales de Git, Toolkit for Visual Studio puede generar y aplicar esas credenciales por usted. Esto puede ahorrarle una cantidad enorme de tiempo.
Para utilizar Visual Studio con AWS CodeCommit, necesita lo siguiente:
• Un usuario de IAM con un conjunto de credenciales (una clave de acceso y una clave secreta) configurado para tal fin. Asimismo, este usuario de IAM debe tener:
Una de las políticas administradas de AWS CodeCommit y la política administrada IAMSelfManageServiceSpecificCredentials aplicada a esta.
O BIEN
Si el usuario de IAM ya tiene las credenciales de Git, una de las políticas administradas AWS CodeCommit o los permisos equivalentes.
Para obtener más información, consulte Políticas administradas (predefinidas) de AWS para AWS CodeCommit (p. 274) y Descripción y obtención de las credenciales de seguridad.
• AWS Toolkit for Visual Studio instalado en el equipo donde haya instalado Visual Studio. Para obtener más información, consulte Configuración de AWS Toolkit for Visual Studio.
Temas
• Paso 1: Obtener una clave de acceso y una clave secreta para su usuario de IAM (p. 17)
• Paso 2: Instalar AWS Toolkit for Visual Studio y conectarse a AWS CodeCommit (p. 18)
• Clonación de un repositorio de AWS CodeCommit desde Visual Studio (p. 19)
• Creación de un repositorio de AWS CodeCommit desde Visual Studio (p. 19)
• Trabajo con repositorios de AWS CodeCommit (p. 20)
Paso 1: Obtener una clave de acceso y una clave secreta para su usuario de IAM
Si no tiene aún configurado un perfil de credenciales en el equipo donde se ha instalado Visual Studio, puede configurar uno con la AWS CLI y el comando aws configure. También puede seguir este
procedimiento para crear y descargar sus credenciales. Proporciónelas a Toolkit for Visual Studio cuando se le solicite.
Para obtener acceso al ID de la clave de acceso y a la clave de acceso secreta de un usuario de IAM
Las claves de acceso constan de un ID de clave de acceso y una clave de acceso secreta, que se utilizan para firmar mediante programación las solicitudes que realiza a AWS. Si no tiene claves de acceso, puede crearlas desde la Consola de administración de AWS. Es recomendable que utilice las claves de acceso de IAM en lugar de las claves de acceso de la Usuario de la cuenta raíz de AWS. IAM le permite controlar de forma segura el acceso a los servicios de AWS y a los recursos de su cuenta de AWS.
Integración de Visual Studio con AWS CodeCommit
El único momento en que puede ver o descargar las claves de acceso secretas es cuando crea las claves.
No puede recuperarlas más adelante. Sin embargo, puede crear nuevas claves de acceso en cualquier momento. También debe tener permisos para realizar las acciones de IAM requeridas. Para obtener más información, consulte Permisos obligatorios para obtener acceso a recursos de IAM en la Guía del usuario de IAM.
1. Abra la consola de IAM.
2. En el panel de navegación de la consola, elija Usuarios.
3. Seleccione su nombre de usuario de IAM (no la casilla de verificación).
4. Elija la pestaña Security credentials y, a continuación, seleccione Create access key.
5. Para ver la nueva clave de acceso, elija Show. Sus credenciales tendrán el aspecto siguiente:
• ID de clave de acceso: AKIAIOSFODNN7EXAMPLE
• Clave de acceso secreta: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
6. Para descargar el par de claves, elija Download .csv file. Almacene las claves en un lugar seguro.
Mantenga las claves en secreto para proteger su cuenta de AWS y no las envíe nunca por correo electrónico. No las comparta fuera de su organización, aunque reciba una petición que parezca provenir de AWS o Amazon.com. Nadie que represente legítimamente a Amazon le pedirá nunca su clave secreta.
Temas relacionados
• ¿Qué es IAM? en la Guía del usuario de IAM
• AWS Security Credentials en AWS General Reference
Paso 2: Instalar AWS Toolkit for Visual Studio y conectarse a AWS CodeCommit
Toolkit for Visual Studio es un paquete de software que puede añadir a Visual Studio. Una vez instalado, puede conectarse a AWS CodeCommit desde Team Explorer en Visual Studio.
Para instalar Toolkit for Visual Studio con el módulo de AWS CodeCommit y configurar el acceso al repositorio del proyecto
1. Instale Visual Studio en su equipo local si no tiene una versión compatible ya instalada.
2. Descargue e instale Toolkit for Visual Studio y guarde el archivo en una carpeta o un directorio local.
Lance el asistente de instalación abriendo el archivo. Cuando se le solicite en la página Getting Started with the AWS Toolkit for Visual Studio, escriba o importe sus credenciales de AWS (la claves de acceso y la clave secreta) y, a continuación, elija Save and Close.
3. En Visual Studio, abra Team Explorer. En Hosted Service Providers, busque AWS CodeCommit y elija Connect.
4. Aplique alguna de las siguientes acciones:
Versión de API 2015-04-13
Integración de Visual Studio con AWS CodeCommit
• Si ya tiene configurado un perfil de credenciales único en el equipo, Toolkit for Visual Studio lo aplicará automáticamente. No hay que hacer nada más. El panel de conexión de AWS CodeCommit aparece en Team Explorer.
• Si tiene configurado más de un perfil de credenciales en el equipo, se le pedirá que elija el que desea utilizar. Elija el perfil asociado con el usuario de IAM que utilizará para conectarse a los repositorios de AWS CodeCommit y, a continuación, seleccione OK.
• Si no tiene configurado ningún perfil, aparecerá un cuadro de diálogo indicando que debe proporcionar las credenciales de seguridad de AWS (la clave de acceso y la clave secreta).
Escríbalas o impórtelas y, a continuación, elija OK.
Una vez que haya iniciado sesión con un perfil, el panel de conexión de AWS CodeCommit aparece en Team Explorer con opciones para clonar, crear o cerrar la sesión. Mediante la opción Clone se clona un repositorio de AWS CodeCommit existente en el equipo local, y podrá comenzar a trabajar con el código.
Esta es la opción que se utiliza con más frecuencia.
Si no tiene repositorios o desea crear uno, seleccione Create. Para obtener más información, consulte Creación de un repositorio de AWS CodeCommit desde Visual Studio (p. 19).
Clonación de un repositorio de AWS CodeCommit desde Visual Studio
Una vez conectado a AWS CodeCommit puede clonar un repositorio en un repositorio local de su equipo.
A continuación, puede comenzar a trabajar con el código.
1. En Manage Connections, seleccione Clone. En Region, seleccione la región de AWS en la que se creó el repositorio en AWS CodeCommit. Elija el repositorio del proyecto y la carpeta de su equipo local en la que desea clonar el repositorio y, a continuación, seleccione OK.
2. Cuando se le pida que cree credenciales de Git, seleccione Yes. El conjunto de herramientas intenta crear credenciales en su nombre. Debe tener la IAMSelfManageServiceSpecificCredentials aplicada al usuario de IAM o los permisos equivalentes. Cuando se le solicite, guarde el archivo de credenciales en un lugar seguro. Esta es la única oportunidad que tendrá para guardar estas credenciales de Git.
Si el conjunto de herramientas no puede crear credenciales de Git en su nombre, o si selecciona No, debe crear y proporcionar sus propias credenciales de Git. Para obtener más información, consulte Usuarios HTTPS mediante credenciales de Git (p. 6)o siga las instrucciones online.
3. Cuando haya terminado de clonar el proyecto, ya puede empezar a editar el código en Visual Studio y confirmar y enviar los cambios al repositorio del proyecto en AWS CodeCommit.
Creación de un repositorio de AWS CodeCommit desde Visual Studio
Puede crear con repositorios de AWS CodeCommit desde Visual Studio con Toolkit for Visual Studio.
Como parte de la creación del repositorio, también debe clonarlo en un repositorio local de su equipo para empezar a trabajar inmediatamente.
1. En Manage Connections, seleccione Create.
2. En Region, elija la región de AWS en la que desea crear el repositorio. Los repositorios de AWS CodeCommit están organizados por región.
3. En Name, escriba un nombre para este repositorio. Los nombres de repositorio deben ser únicos dentro de una cuenta de AWS. Existen límites de caracteres y de longitud. Para obtener más información, consulte Límites (p. 298). Opcionalmente, en Description, escriba una descripción para este repositorio. Esto ayuda a otras personas a comprender para qué se utiliza el repositorio y ayuda a distinguirlo de otros repositorios de la región.
Integración de Eclipse con AWS CodeCommit
4. En Clone into, escriba o acceda a la carpeta o el directorio donde desee clonar este repositorio en su equipo local. Visual Studio clona automáticamente el repositorio una vez creado y crea el repositorio local en la ubicación que elija.
5. Cuando esté satisfecho con las opciones que ha elegido, seleccione OK.
6. Si le piden que cree credenciales de Git, seleccione Sí. El conjunto de herramientas intenta crear credenciales en su nombre. Debe tener la IAMSelfManageServiceSpecificCredentials aplicada al usuario de IAM o los permisos equivalentes. Cuando se le solicite, guarde el archivo de credenciales en un lugar seguro. Esta es la única oportunidad que tendrá para guardar estas credenciales de Git.
Si el conjunto de herramientas no puede crear credenciales de Git en su nombre, o si selecciona No, debe crear y proporcionar sus propias credenciales de Git. Para obtener más información, consulte Usuarios HTTPS mediante credenciales de Git (p. 6)o siga las instrucciones online.
Trabajo con repositorios de AWS CodeCommit
Una vez conectado a AWS CodeCommit, podrá ver una lista de repositorios asociados a su cuenta de AWS. Puede examinar el contenido de estos repositorios en Visual Studio. Abra el menú contextual del repositorio que le interesa y elija Browse en Console.
Las operaciones de Git en Visual Studio para los repositorios de AWS CodeCommit funcionan
exactamente igual que para cualquier otro repositorio basado en Git. Puede realizar cambios en el código, añadir archivos y crear confirmaciones locales. Cuando esté preparado para compartir, debe usar la opción de sincronización de Team Explorer para enviar sus confirmaciones al repositorio de AWS CodeCommit.
Dado que las credenciales de Git para el usuario de IAM ya están almacenadas localmente y asociadas a su perfil de credenciales de AWS conectado, no será necesario proporcionarlas de nuevo cuando realiza envíos a AWS CodeCommit.
Para obtener más información acerca de cómo trabajar con Toolkit for Visual Studio, consulte la Guía del usuario de AWS Toolkit for Visual Studio.
Integración de Eclipse con AWS CodeCommit
Puede utilizar Eclipse para realizar cambios en el código en un repositorio de AWS CodeCommit. La integración con Toolkit for Eclipse está diseñada para funcionar con credenciales de Git y un usuario de IAM. Puede clonar repositorios existentes, crear repositorios, confirmar y enviar cambios en el código a un repositorio y mucho más.
Para utilizar Toolkit for Eclipse con AWS CodeCommit, se requiere que:
• Eclipse esté instalado en el equipo local.
• Un usuario de IAM con un conjunto de credenciales (una clave de acceso y una clave secreta) configurado para tal fin. Asimismo, este usuario de IAM debe tener:
Una de las políticas administradas de AWS CodeCommit y la política administrada IAMSelfManageServiceSpecificCredentials aplicada a esta.
O BIEN
Si el usuario de IAM ya tiene las credenciales de Git, una de las políticas administradas AWS CodeCommit o los permisos equivalentes.
Para obtener más información, consulte Políticas administradas (predefinidas) de AWS para AWS CodeCommit (p. 274) y Descripción y obtención de las credenciales de seguridad.
• Un conjunto activo de credenciales de Git esté configurado para el usuario en IAM. Para obtener más información, consulte Paso 3: Crear credenciales de Git para conexiones HTTPS al AWS CodeCommit (p. 7).
Versión de API 2015-04-13
Integración de Eclipse con AWS CodeCommit
Temas
• Paso 1: Obtener una clave de acceso y una clave secreta para su usuario de IAM (p. 21)
• Paso 2: Instalar AWS Toolkit for Eclipse y conectarse a AWS CodeCommit (p. 22)
• Clonación de un repositorio de AWS CodeCommit desde Eclipse (p. 23)
• Creación de un repositorio de AWS CodeCommit desde Eclipse (p. 24)
• Trabajo con repositorios de AWS CodeCommit (p. 25)
Paso 1: Obtener una clave de acceso y una clave secreta para su usuario de IAM
Si no tiene aún configurado un perfil de credenciales en el equipo donde se ha instalado Eclipse, puede configurar uno con la AWS CLI y el comando aws configure. También puede seguir este procedimiento para crear y descargar sus credenciales. Proporciónelas a Toolkit for Eclipse cuando se le solicite.
Para obtener acceso al ID de la clave de acceso y a la clave de acceso secreta de un usuario de IAM
Las claves de acceso constan de un ID de clave de acceso y una clave de acceso secreta, que se utilizan para firmar mediante programación las solicitudes que realiza a AWS. Si no tiene claves de acceso, puede crearlas desde la Consola de administración de AWS. Es recomendable que utilice las claves de acceso de IAM en lugar de las claves de acceso de la Usuario de la cuenta raíz de AWS. IAM le permite controlar de forma segura el acceso a los servicios de AWS y a los recursos de su cuenta de AWS.
El único momento en que puede ver o descargar las claves de acceso secretas es cuando crea las claves.
No puede recuperarlas más adelante. Sin embargo, puede crear nuevas claves de acceso en cualquier momento. También debe tener permisos para realizar las acciones de IAM requeridas. Para obtener más información, consulte Permisos obligatorios para obtener acceso a recursos de IAM en la Guía del usuario de IAM.
1. Abra la consola de IAM.
2. En el panel de navegación de la consola, elija Usuarios.
3. Seleccione su nombre de usuario de IAM (no la casilla de verificación).
4. Elija la pestaña Security credentials y, a continuación, seleccione Create access key.
5. Para ver la nueva clave de acceso, elija Show. Sus credenciales tendrán el aspecto siguiente:
• ID de clave de acceso: AKIAIOSFODNN7EXAMPLE
• Clave de acceso secreta: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
6. Para descargar el par de claves, elija Download .csv file. Almacene las claves en un lugar seguro.
Mantenga las claves en secreto para proteger su cuenta de AWS y no las envíe nunca por correo electrónico. No las comparta fuera de su organización, aunque reciba una petición que parezca provenir de AWS o Amazon.com. Nadie que represente legítimamente a Amazon le pedirá nunca su clave secreta.
Temas relacionados
• ¿Qué es IAM? en la Guía del usuario de IAM
• AWS Security Credentials en AWS General Reference
Integración de Eclipse con AWS CodeCommit
Paso 2: Instalar AWS Toolkit for Eclipse y conectarse a AWS CodeCommit
Toolkit for Eclipse es un paquete de software que puede añadir a Eclipse. Una vez instalado y configurado con su perfil de credenciales de AWS, puede conectarse a AWS CodeCommit desde AWS Explorer en Eclipse.
Para instalar Toolkit for Eclipse con el módulo de AWS CodeCommit y configurar el acceso al repositorio del proyecto
1. Instale Toolkit for Eclipse en su equipo local si no tiene una versión compatible ya instalada. Si necesita actualizar su versión de Toolkit for Eclipse, siga las instrucciones en Set Up the Toolkit.
2. En Eclipse, siga la experiencia de primer uso o abra Preferences desde el sistema de menús de Eclipse (la ubicación exacta variará en función de la versión y el sistema operativo) y elija AWS Toolkit.
3. Aplique alguna de las siguientes acciones:
• Si está siguiendo la experiencia de primer uso, proporcione las credenciales de seguridad de AWS cuando se le solicite que configure el perfil de credenciales.
• Si está realizando una configuración en Preferences y ya tiene configurado un perfil de credenciales en su equipo, selecciónelo en la lista Default Profile.
• En caso de que esté realizando una configuración en Preferences y no ve el perfil que desea utilizar, o si la lista está vacía, seleccione Add profile. En Profile Details, proporcione un nombre para el perfil y las credenciales del usuario de IAM (clave de acceso y clave secreta) o bien proporcione la ubicación del archivo de credenciales.
• Si está realizando una configuración en Preferencias pero no tiene configurado ningún perfil, utilice los enlaces para inscribirse en una cuenta nueva o administrar las credenciales de seguridad de AWS ya existentes.
4. En Eclipse, amplíe el menú AWS Toolkit y elija AWS CodeCommit. Seleccione su perfil de
credenciales y, a continuación, escriba el nombre de usuario y la contraseña para las credenciales de Git o impórtelas desde el archivo .csv. Elija Apply y, después, OK.
Versión de API 2015-04-13
Integración de Eclipse con AWS CodeCommit
Una vez que haya iniciado sesión con un perfil, el panel de conexión de AWS CodeCommit aparece en Team Explorer con opciones para clonar, crear o cerrar la sesión. Mediante la opción Clone se clona un repositorio de AWS CodeCommit existente en el equipo local, y podrá comenzar a trabajar con el código.
Esta es la opción que se utiliza con más frecuencia.
Si no tiene repositorios o desea crear uno, seleccione Create.
Clonación de un repositorio de AWS CodeCommit desde Eclipse
Una vez configuradas las credenciales, puede clonar un repositorio en un repositorio local de su equipo mediante su comprobación en Eclipse. A continuación, puede comenzar a trabajar con el código.
1. En Eclipse, abra AWS Explorer. Para obtener más información acerca de dónde encontrarlo, consulte How to Access AWS Explorer. Amplíe AWS CodeCommit y elija el repositorio de AWS CodeCommit con el que desea trabajar. Puede ver el historial de confirmaciones y otros detalles del repositorio, lo que puede ayudarle a determinar si este es el repositorio y la ramificación que desea clonar.
Note
Si no ve el repositorio, elija la marca para abrir el menú de regiones de AWS, y seleccione la región en la que se ha creado el repositorio.