Documentación Commerce Guía de Commerce en la infraestructura en la nube

Administrar ramas con la CLI

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:
Nube

Creado para:

Desarrollador

Para instalar la CLI magento-cloud, consulte la referencia de CLI de nube. Después de instalar la CLI magento-cloud y de configurar las claves SSH para el acceso remoto a su infraestructura en la nube, puede usar los comandos CLI magento-cloud para administrar los entornos de sus proyectos. Para obtener información acerca de la arquitectura del entorno, consulte Arquitectura inicial o Arquitectura profesional.

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

Utilizar comandos CLI

Los comandos CLI magento-cloud 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 el parámetro -p <project-ID>. Consulte la referencia de CLI de nube.

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, use el comando magento-cloud list.

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 usando el comando magento-cloud environment:branch <branch-name> para que el entorno se vuelva activo. También puede usar Cloud Console para crear entornos activos. Consulte Referencia de CLI de nube.

Para clonar un entorno de proyecto master:

Inicie sesión en la estación de trabajo local con una cuenta de propietario del sistema de archivos.
Cambie al directorio docroot del servidor web o del host virtual.

Inicie sesión con la CLI magento-cloud.

code language-bash
`magento-cloud login`

Enumere sus proyectos.

code language-bash
`magento-cloud project:list`

Clonar un proyecto.

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

Cuando se le solicite, proporcione un nombre de directorio.

Cambie al directorio magento2.

Enumerar los entornos disponibles para el proyecto.

code language-bash
`magento-cloud environment:list`

note important
IMPORTANT
El comando `magento-cloud environment:list` muestra jerarquías de entorno, mientras que el comando `git branch` no lo hace.

Recupere las ramas remotas.

code language-bash
`git fetch origin`

Extraer código actualizado.

code language-bash
`git pull origin <environment-ID>`

TIP

Consulte Integraciones para obtener información sobre cómo usar los 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 dijo anteriormente, debe crear un entorno usando el comando magento-cloud environment:branch <branch-name> o el Cloud Console para que el entorno se vuelva activo.

Para Starter, considere la posibilidad de crear una rama para staging y después cree una rama de desarrollo basada en la rama staging.
Para Pro, cree ramas de desarrollo basadas en la rama Integration.

Para crear una rama de desarrollo:

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

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`

Actualizar dependencias.

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

[opcional] Crear una copia de seguridad del entorno.

Combinar una rama

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

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>`

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 la rama master de ningún 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 en la nube.

Cuando elimina 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:

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

Buscar actualizaciones del servidor remoto.

code language-bash
`git fetch`

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>`

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

code language-none
`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 un estado inactivo.

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

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

Espere a que se elimine el entorno.

code language-none

code language-none
`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.`

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, use el comando magento-cloud environment:activate.

Interacción con entornos remotos

Una vez que haya configurado las claves SSH, podrá conectarse desde su área de trabajo local a un entorno remoto, interactuar con los servicios del proyecto y modificar la configuración.

recommendation-more-help

05f2f56e-ac5d-4931-8cdb-764e60e16f26