Configurar un repositorio Git remoto en Control Room

Configurar un repositorio Git remoto en Control Room para que pueda versionar todos los bots y sus dependencias y almacenarlos en el repositorio Git. Además del repositorio local de Automation 360 en Control Room, el Git remoto proporciona una copia de respaldo para los bots y sus dependencias.

Antes de empezar

  • Para configurar un repositorio Git remoto en Control Room, asegúrese de tener el rol AAE_Admin.
  • Dependiendo de su región, configure el firewall de su red para añadir las direcciones IP de la puerta de enlace NAT saliente a la lista de permitidas.

    Direcciones IP de Automation 360 para integraciones externas

Cuando vaya a configurar un repositorio de Git remoto, tenga en cuenta las siguientes consideraciones:
  • El repositorio de Git debe configurarse para tener acceso de escritura solo a Control Room y no a ningún otro cliente de Git.
  • No puede cargar archivos de más de 100 MB al repositorio Git.
  • Asegúrese de que se integre con un repositorio de Git vacío.
  • No debe registrar ningún archivo manualmente en el repositorio de Git desde ningún otro usuario, producto o aplicación.
  • Cuando se integra con Git, el repositorio no debe contener el archivo ReadMe.md.
  • Asegúrese de que su repositorio de Git sea privado (interno). Por razones de seguridad, Automation 360 no se puede conectar a un repositorio público de Git, ya que todos los bots y los archivos suelen ser accesibles en un repositorio público de Git.

Procedimiento

  1. En Control Room, navegue hasta Administración > Configuración > Integración de repositorio Git remoto.
  2. Haga clic en Editar.
  3. Elija uno de los siguientes métodos de autenticación y realice los pasos correspondientes para establecer su configuración de Git:
    Método de autenticaciónPasos
    Autenticación de HTTPS
    1. Ingrese la ruta del repositorio HTTPS, incluyendo el nombre de usuario en el siguiente formato:

      https://<username>@bitbucket.org/companyname/product.git

      Nota: Utilice el host de Git que desea para obtener la dirección del repositorio de Git.
    2. Ingrese el nombre de la rama.

      Los cambios se envían a la rama seleccionada. De forma predeterminada, se selecciona la rama maestra.

      Puede usar caracteres en minúscula para los nombres de las sucursales, pero no deben superar los 250 caracteres. No incluya caracteres de control ASCII, como espacios, tildes o dos puntos en nombres de sucursales. Puede usar el guion para separar palabras. Para obtener más información sobre los nombres de ramas, consulte Create a new Git branch.

    3. Ingrese la contraseña de su repositorio Git o un token Git generado.
      Nota:
      • La longitud del token debe limitarse a 75 caracteres.
      • Debe introducir la contraseña generada para la conexión a su repositorio. Se recomienda utilizar tokens, ya que son más seguros que las contraseñas.
      • En el caso de GitHub, debe utilizar únicamente los tokens de acceso personal (clásicos). Los tokens de acceso personal (detallado) no funcionan en GitHub.
      • Para BitButcket, debe utilizar únicamente las contraseñas de la aplicación.
    4. Vuelva a introducir la contraseña o el token Git para confirmar.
    Autenticación de SSH
    1. Ingrese la ruta del repositorio de SSH en el siguiente formato:

      https://git@bitbucket.org:companyname/product.git

      Nota: Utilice el host de Git que desea para obtener la dirección del repositorio de Git.
    2. Ingrese el nombre de la rama.

      Los cambios se envían a la rama seleccionada. De forma predeterminada, se selecciona la rama maestra.

      Puede usar caracteres en minúscula para los nombres de las sucursales, pero no deben superar los 250 caracteres. No incluya caracteres de control ASCII, como espacios, tildes o dos puntos en nombres de sucursales. Puede usar el guion para separar palabras. Para obtener más información sobre los nombres de ramas, consulte Create a new Git branch.

    3. Ingrese su clave privada de autenticación SSH.

      Debe crear el par de claves privadas y públicas utilizando el algoritmo RSA.

      Nota: Asegúrese de que la clave privada ingresada en Control Room contenga la siguiente cadena: -----COMENZAR LLAVE PRIVADA RSA----- Y -----FINALIZAR CLAVE PRIVADA RSA-----

      Debe generar la clave pública e ingresarla en su servidor Git.

      Consulte los temas siguientes para saber cómo generar la clave pública en función de su servidor:
    4. Opcional: Introduzca la contraseña.
  4. Opcional: Seleccione la casilla de verificación Conectarse a Git mediante un proxy.
    1. Introduzca el nombre del host proxy o la dirección IP.
    2. Escriba el número del puerto.
    3. Opcional: Seleccione la casilla de verificación de autenticación e ingrese el nombre de usuario y la contraseña.
  5. Haga clic en Conectar y Guardar.
    La Control Room se conecta al repositorio Git remoto, y se muestra el siguiente mensaje: La configuración de la integración de Git se guardó correctamente. También puede comprobar el registro de auditoría donde se muestra el estado de Establecer configuraciones Git como exitoso.
Nota:
  • La operación de registro puede tardar más si tiene muchos archivos bot en su carpeta Git del espacio de trabajo público. Esto se debe a que un aumento del tamaño del repositorio provoca una ralentización de la confirmación de git. Como práctica recomendada, le recomendamos que elimine los archivos bot que no utilice de su espacio de trabajo público.
  • Si el repositorio Git tiene algún archivo de bloqueo como index.lock o master.lock, elimine estos archivos de bloqueo ya que podrían dificultar las operaciones de registro de entrada y de salida.

Puede conectarse al mismo repositorio Git con un nombre de usuario diferente en la Control Room. Para obtener más información, consulte How to change the remote Git repository username in the control room (A-People login required).

Vea el siguiente video para obtener un resumen de Git: