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

Administrar ramas con la CLI

Last update: Wed Apr 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Developer

Para instalar el magento-cloud CLI, consulte la Referencia de CLI de Cloud. Después de instalar el magento-cloud CLI y configurar claves SSH para el acceso remoto a su infraestructura en la nube, puede utilizar magento-cloud Comandos CLI para administrar los entornos de sus proyectos. Para obtener información sobre la arquitectura del entorno, consulte Arquitectura de inicio o Arquitectura profesional.

Para administrar las ramas y los entornos con Cloud Console, consulte Administrar ramas con Cloud Console.

Utilizar comandos CLI

El magento-cloud Los comandos CLI son similares a los comandos Git. Puede utilizarlas para conectarse al proyecto y administrar los entornos. Aunque puede ejecutar los comandos desde cualquier directorio, se recomienda ejecutarlos desde un directorio de proyecto. Cuando se ejecuta desde un directorio de proyecto, puede omitir la variable -p <project-ID> parámetro. Consulte la Referencia de CLI de Cloud.

Clonar el proyecto

Las siguientes instrucciones utilizan una combinación de magento-cloud Comandos CLI y comandos Git para clonar el proyecto en la estación de trabajo local. Para ver una lista completa de magento-cloud Comandos CLI, utilice el magento-cloud list comando.

IMPORTANT
Algunos comandos Git no pueden completar una acción en su proyecto de infraestructura en la nube de Adobe Commerce. Por ejemplo, puede crear una rama con un comando Git, pero no puede crear y activar un entorno nuevo. Debe crear un entorno utilizando la variable magento-cloud environment:branch <branch-name> para que el entorno se convierta en activo. Como alternativa, puede utilizar la variable Cloud Console para crear entornos activos. Consulte Referencia de CLI de Cloud.

Para clonar un proyecto master entorno:

  1. Inicie sesión en la estación de trabajo local con una propietario del sistema de archivos cuenta.

  2. Cambiar al servidor web o al host virtual docroot directorio.

  3. Inicie sesión con el magento-cloud CLI.

    code language-bash 
    magento-cloud login

  4. Enumere sus proyectos.

    code language-bash 
    magento-cloud project:list

  5. Clonar un proyecto.

    code language-bash 
    magento-cloud project:get <project-ID>

    Cuando se le solicite, proporcione un nombre de directorio.

  6. Cambie a la magento2 directorio.

  7. Enumerar los entornos disponibles para el proyecto.

    code language-bash 
    magento-cloud environment:list
    note important
    IMPORTANT
    El magento-cloud environment:list muestra las jerarquías de entorno, mientras que la variable git branch El comando no.

  8. Recupere las ramas remotas.

    code language-bash 
    git fetch origin

  9. Extraer código actualizado.

    code language-bash 
    git pull origin <environment-ID>
TIP
Consulte Integraciones para obtener información sobre el uso de servicios de alojamiento basados en Git con Adobe Commerce en la infraestructura en la nube.

Crear una rama para desarrollo

Después de clonar el proyecto y actualizar la configuración de cuenta de administrador de Adobe Commerce, puede ramificar para desarrollo. Como se ha indicado anteriormente, debe crear un entorno utilizando magento-cloud environment:branch <branch-name> para el Cloud Console para que el entorno se convierta en activo.

  • Para Starter, considere la posibilidad de crear una rama para staging, luego cree una rama de desarrollo basada en el staging Rama.
  • Para Pro, cree ramas de desarrollo basadas en Integration Rama.

Para crear una rama de desarrollo:

  1. En la estación de trabajo local, cambie al directorio del proyecto.

  2. Cree un entorno basado en la rama recomendada para el flujo de trabajo del proyecto.

    code language-bash 
    magento-cloud branch <new-environment-name> integration

  3. Actualizar dependencias.

    code language-bash 
    composer --no-ansi --no-interaction install --no-progress --prefer-dist --optimize-autoloader

  4. [opcional] Crear un reserva del entorno.

Combinar una rama

Después de completar el desarrollo, combine esta rama con la principal:

  1. Confirmar y enviar cambios de código:

    code language-bash 
    git add -A && git commit -m "Add message here"
    code language-bash 
    git push origin <branch-name>

  2. Combinar con el entorno principal:

    code language-bash 
    magento-cloud environment:merge <environment-ID>

Eliminar un entorno

Solo elimine un entorno si está seguro de que ya no lo necesita. No puede recuperar un entorno después de eliminarlo.

WARNING
No puede eliminar el master rama de cualquier proyecto.

Debe ser administrador de proyecto, administrador de entorno o propietario de cuenta para realizar esta tarea. Consulte Administrar el acceso de los usuarios a los proyectos de Cloud.

Al eliminar un entorno, el entorno se establece en inactivo. El código sigue disponible en la rama Git, pero ya no contiene los servicios ni la base de datos. Para eliminar el entorno por completo, también debe eliminar la rama Git remota correspondiente.

Para eliminar un entorno:

  1. En la estación de trabajo local, cambie al directorio del proyecto.

  2. Buscar actualizaciones del servidor remoto.

    code language-bash 
    git fetch

  3. Elimine la rama de entorno.

    code language-bash 
    magento-cloud environment:delete <environment-ID>

    De forma opcional, puede eliminar más de un entorno a la vez si agrega varios ID de entorno al comando Eliminar.

    code language-bash 
    magento-cloud environment:delete <environment-1-ID> <environment-2-ID>

  4. Responda a las solicitudes para eliminar el entorno local y el entorno remoto correspondiente.

    code language-terminal 
    The environment <environment-ID> is currently active: deleting it will delete all associated data.
Are you sure you want to delete the environment <environment-ID>? [Y/n]

    Al eliminar el entorno, se coloca en una inactivo estado.

    code language-terminal 
    Delete the remote Git branch too? [Y/n]

    Al eliminar la rama Git remota, se elimina el entorno del proyecto.

  5. Espere a que se elimine el entorno.

    code language-terminal 
    Deleting environment <environment-ID>
Waiting for the activity...
  Deleting environment <project-id>-<environment-ID>-xxxxxx

  [============================]  1 min (complete)
Activity ID succeeded
Deleted remote Git branch <environment-ID>
Run git fetch --prune to remove deleted branches from your local cache.
TIP
Para activar un entorno inactivo, utilice el magento-cloud environment:activate comando.

Interacción con entornos remotos

Después de usted configuración de claves SSH, puede conectarse desde el espacio de trabajo local a un entorno remoto e interactuar con los servicios del proyecto y modificar la configuración.

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