DocumentaciónCommerceGuía de Commerce en la infraestructura en la nube

Administrar ramas con Cloud Console

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Desarrollador

Puede administrar sus entornos mediante la CLI Cloud Console o magento-cloud. Los archivos de proyecto se almacenan en un repositorio Git. Puede usar comandos Git para administrar su código, pero la CLI de magento-cloud está diseñada para interactuar con características de plataforma, mientras que los comandos Git no lo hacen. Consulte Comandos Git en el tema de la CLI de la nube.

En este tema se explica cómo usar Cloud Console para:

  • Agregar o eliminar un entorno
  • Sincronizar (git pull) desde el entorno principal
  • Combinar (git push) con el entorno principal
TIP
No puede crear ramas desde entornos de ensayo y producción profesionales. Puede bifurcar desde la rama master.

Crear un entorno

La estrategia de ramificación utiliza un flujo de trabajo Git común en el que se desarrolla código y se añaden extensiones en una rama de desarrollo. Ver las descripciones generales de la arquitectura de Starter y Pro.

  • Para empezar, cree una rama staging desde la rama master y luego una rama desde staging para desarrollo.
  • Para Pro, cree una rama de desarrollo a partir del entorno Integration.

Su cuenta admite un número limitado de ramas de desarrollo activas {width="32"} (active) and an unlimited number of inactive branch {width="32"} (inactivas). Administre ramas activas e inactivas agregando o eliminando una rama usando solamente la Cloud Console o la CLI de nube. Antes de eliminar una rama, debe desactivarla, que permanece en la lista Entornos como inactiva. Puede reactivar la rama más tarde o eliminar la rama en la configuración del entorno o mediante la CLI de nube.

Si necesita entornos activos adicionales para el desarrollo, envíe un ticket de asistencia.

Para agregar una rama:

  1. Inicie sesión en Cloud Console.

  2. Seleccione un proyecto de la lista Todos los proyectos.

  3. Seleccione un entorno.

    note tip
    TIP
    La nueva rama se clona desde este entorno. Elija un entorno principal similar al entorno que está a punto de crear.

  4. Haga clic en Branch.

    Crear una rama {width="150"}

  5. En el formulario Bifurcación desde…, escriba un nombre de rama.

    El entorno name es diferente del entorno ID solo si el nombre del entorno contiene espacios o mayúsculas. Un ID de entorno consta de todas las letras minúsculas, números y símbolos permitidos. Las letras mayúsculas en un nombre de entorno se convierten a minúsculas en el ID.; los espacios en un nombre de entorno se convierten en guiones.

    Un nombre de entorno no puede incluir caracteres reservados para su shell de Linux o para expresiones regulares. Los caracteres prohibidos incluyen llaves ({ }), paréntesis, asteriscos (*), corchetes angulares (>), signo ampersand (&), porcentaje (%) y otros caracteres.

  6. Seleccione un(a) Environment type.

  7. Haga clic en Create Branch.

  8. Espere mientras se implementa el entorno.

    Durante la implementación, el estado del entorno es En proceso. Después de una implementación correcta, el estado cambia a una marca de verificación verde para success.

Crear rama inactiva

No puede crear una rama inactiva desde la consola de Adobe Commerce Cloud o CLI. Si desea crear una rama inactiva, créela en el repositorio Git y haga una inserción mediante la opción environment.Parent del comando.

git push -o "environment.Parent=<parent branch>" <origin> <branch>

Eliminar un entorno

Antes de poder eliminar un entorno, debe desactivarlo. Una vez que un entorno esté inactivo, puede eliminarlo.

Para desactivar un entorno:

  1. Inicie sesión en Cloud Console.

  2. Seleccione un proyecto de la lista Todos los proyectos.

  3. Seleccione el entorno de la lista de la barra de navegación Entorno.

  4. Haga clic en el icono de configuración en la parte derecha de la barra de navegación superior, que abre la configuración del entorno.

  5. En la ficha General, desplácese hacia abajo hasta la sección​ Deactivate environment, haga clic en Deactivate environment and delete data y siga las instrucciones.

Sincronizar un entorno

La sincronización de un entorno (o rama) es la misma que git pull origin <parent>. Puede sincronizar el código actualizado desde un entorno principal. Puede utilizar esta característica a través de Cloud Console para todos los entornos Starter y Pro.

En el plan Pro, puede sincronizar desde Ensayo y producción a su rama master. Esta sincronización solo extrae y inserta código, no datos. Para sincronizar datos, volque los datos de la base de datos y empújelos a la base de datos de otro entorno. Ver Migrar e implementar datos y archivos estáticos.

Para sincronizar un entorno:

  1. Inicie sesión en Cloud Console.

  2. Seleccione un proyecto de la lista Todos los proyectos.

  3. En la lista de entornos, haga clic en el nombre de la rama que desea sincronizar.

  4. Haga clic en (sincronizar).

    Sincronizar un entorno {width="150"}

  5. Seleccione los elementos que desea sincronizar.

    • Reemplazar los datos (datos y archivos): sincroniza los cambios de la base de datos y los archivos de contenido de la rama principal.
    • Combinar: (código) sincroniza el código actualizado de la rama principal.

    Esto también genera un comando CLI para que usted copie y utilice.

  6. Haga clic en Sincronizar.

Combinar con el entorno principal

Combinar un entorno (o rama) es lo mismo que git push origin. Puede combinar para insertar el código actualizado de un entorno a su entorno principal. Puede combinar este código con master. Puede implementar en Ensayo y producción utilizando el comando merge.

Para combinar con el entorno principal:

  1. Inicie sesión en Cloud Console.

  2. Seleccione un proyecto de la lista Todos los proyectos.

  3. En la lista entorno, haga clic en el nombre de la rama que desea combinar.

  4. Haga clic en (combinar).

    Combinar un entorno {width="150"}

  5. Haga clic en Combinar y confirme la acción.

Ver registros

A través de Cloud Console, puede revisar varios registros para entornos, incluidos los de compilación, implementación e historial de implementación.

Para Starter, puede revisar los registros de compilación e implementación y el historial de implementación. Estos entornos incluyen la rama master (Producción) y todas las ramas creadas a partir de ella.

Para Pro, puede revisar los siguientes registros en cada entorno:

  • Integración: generación e implementación e historial de implementación
  • Ensayo: registros de compilación e historial de implementación. Utilice SSH para iniciar sesión en el servidor y ver los registros de implementación.
  • Producción: registros de compilación e historial de implementación. Utilice SSH para iniciar sesión en el servidor y ver los registros de implementación.

Para ver los registros deCloud Console:

  1. Inicie sesión en Cloud Console.

  2. Seleccione un proyecto de la lista Todos los proyectos.

  3. Seleccione un entorno.

    La vista de entorno proporciona una lista de actividades que muestra eventos recientes, una entrada por cada acción intentada, incluidas sincronizaciones, combinaciones, ramas, copias de seguridad y más. Haga clic en Todos para ver el historial de implementación completo.

  4. Para ver el registro de generación, seleccione el vínculo Éxito o Error por registro de implementación en la cuenta.

TIP
Haga clic en el icono Filtrar por en una lista desplegable y seleccione el tipo de mensajes que desea ver.

Extraer código de un repositorio Git privado

Su proyecto de infraestructura de Adobe Commerce en la nube puede incluir código de un repositorio Git privado. Por ejemplo, puede tener código para un módulo o tema personalizado en un repositorio privado. Para ello, debe agregar la clave SSH pública del proyecto a su repositorio Git privado y actualizar el archivo del proyecto composer.json.

Para agregar una clave de implementación al repositorio privado de GitHub, debe ser el administrador de dicho repositorio. GitHub le permite utilizar una clave de implementación solo para un repositorio.

Si prefiere que su proyecto acceda a varios repositorios, puede adjuntar una clave SSH a una cuenta de usuario automatizada. Dado que esta cuenta no la usa un humano, se denomina usuario de equipo. Agregue la cuenta del equipo como colaborador o agregue el usuario del equipo a un equipo con acceso a los repositorios.

INFO
El Adobe recomienda añadir y combinar este código en los repositorios Git del proyecto. Si no configura la conexión, es posible que experimente problemas de compilación.

Para encontrar su clave pública SSH:

  1. Inicie sesión en Cloud Console.

  2. Seleccione un proyecto de la lista Todos los proyectos.

  3. Haga clic en el icono de configuración en la parte derecha de la barra de navegación superior.

  4. En Configuración del proyecto, haga clic en Deploy Key.

  5. Copie la clave de implementación en el portapapeles para usarla en uno de los siguientes métodos basados en Git:

GitHub

Introduzca la clave de implementación de GitHub

En GitHub, las claves de implementación son de solo lectura de forma predeterminada.

Para escribir la clave pública del proyecto como clave de implementación de GitHub:

  1. Inicie sesión en el repositorio de GitHub como administrador.

  2. Haga clic en la ficha Settings del repositorio.

    note note
    NOTE
    Si no ve esta opción, no ha iniciado sesión como administrador del repositorio y no puede completar esta tarea. Pida al administrador del repositorio de GitHub que lo haga.

  3. En la ficha Configuración de la navegación izquierda, haga clic en Deploy Keys.

  4. Haga clic en Add deploy key.

  5. Siga las indicaciones.

En composer.json, use el formato <user>@<host>:<.git</code> o ssh://<user>@<host>:<port>/<path>.git si usa un puerto no estándar.

Bits

Introduzca la clave de implementación de Bitbucket

Para escribir la clave pública del proyecto como clave de implementación de bloque de bits:

  1. Inicie sesión en el repositorio de Bitbucket como administrador.

  2. En el panel de navegación izquierdo, haga clic en Settings.

  3. Haga clic en General > Deployment Keys.

  4. Haga clic en Add Key.

  5. Siga las indicaciones.

GitLab

Introduzca la clave de implementación de GitLab

Para agregar la clave SSH pública para su proyecto como clave de implementación de GitLab:

  1. Inicie sesión en el repositorio de GitLab como propietario.

  2. Compruebe que la opción Canalizaciones esté habilitada para su proyecto:

    1. En la configuración del proyecto, expanda la sección Visibility, project, features, permissions.
    2. Si es necesario, haga clic en Pipelines para habilitar la opción.

  3. Añada la clave SSH pública a la configuración de CI/CD.

    1. En el panel de navegación izquierdo, haga clic en Configuración > CI / CD.
    2. Haga clic en Implementar claves Expand para configurar la clave.
    3. En el formulario Implementar clave, agregue un nombre de clave de implementación al campo Title y pegue la clave SSH pública en el campo Key.
    4. Haga clic en Add Key para guardar la configuración.

Entornos y ramas seguros

Puede acceder a su proyecto y entornos desde cualquier ubicación a través de un explorador web utilizando Cloud Console. Es posible que tenga la seguridad configurada para su entorno de producción, tiendas y sitios. Esta sección le ayuda a proteger los entornos de integración y ensayo estrictamente para desarrolladores, DBA y mucho más.

WARNING
NO usa los siguientes métodos para proteger los entornos de ensayo y producción de Pro. Esto interrumpe el almacenamiento en caché de Fastly. Utilice la función Bloqueo disponible en la CDN de Fastly para Adobe Commerce.

Para proteger entornos:

  1. Inicie sesión en Cloud Console.

  2. Seleccione un proyecto de la lista Todos los proyectos.

  3. Seleccione un entorno y haga clic en el icono de configuración en la barra de navegación.

  4. En la ficha Configuración del entorno General, haga clic en ACTIVADO para HTTP access control enabled para habilitar el acceso seguro. Puede elegir entre credenciales o direcciones IP para filtrar el acceso.

  5. Para filtrar por credenciales, haga clic en Add Login, escriba un nombre de usuario y una contraseña y haga clic en Add Login para agregar.

  6. Para filtrar por dirección IP, escriba las direcciones IP en una lista con deny o allow. Por ejemplo:

    code language-text 
    123.456.789.111/29 allow
123.456.789.112/29 allow
234.123.567.111/29 allow
0.0.0.0/0 deny

  7. Haga clic en Save. Esto vuelve a implementar el entorno para actualizar la seguridad y la configuración. El Adobe recomienda probar el entorno después de completar la configuración de seguridad.

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26