DocumentaçãoCommerceGuia do Commerce na infraestrutura em nuvem

Gerenciar ramificações com a CLI

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

Criado para:

  • Desenvolvedor

Para instalar a CLI do magento-cloud, consulte a Referência da CLI da Nuvem. Depois de instalar a CLI do magento-cloud e configurar chaves SSH para acesso remoto à sua infraestrutura de nuvem, você pode usar comandos da CLI do magento-cloud para gerenciar os ambientes dos seus projetos. Para obter informações sobre a arquitetura de ambiente, consulte Arquitetura de início ou Arquitetura Pro.

Para gerenciar ramificações e ambientes com o Cloud Console, consulte Gerenciar ramificações com o Cloud Console.

Usar comandos da CLI

Os comandos da CLI magento-cloud são semelhantes aos comandos do Git. Você pode usá-los para se conectar ao seu projeto e gerenciar seus ambientes. Embora seja possível executar os comandos a partir de qualquer diretório, é recomendável executá-los a partir de um diretório do projeto. Quando executado de um diretório de projeto, você pode omitir o parâmetro -p <project-ID>. Consulte a Referência da CLI da nuvem.

Clonar o projeto

As instruções a seguir usam uma combinação de comandos da CLI do magento-cloud e comandos do Git para clonar seu projeto em sua estação de trabalho local. Para ver uma lista completa de comandos CLI do magento-cloud, use o comando magento-cloud list.

IMPORTANT
Alguns comandos do Git não podem concluir uma ação no projeto Adobe Commerce na infraestrutura em nuvem. Por exemplo, você pode criar uma ramificação usando um comando Git, mas não pode criar e ativar um novo ambiente. Você deve criar um ambiente usando o comando magento-cloud environment:branch <branch-name> para que o ambiente se torne ativo. Como alternativa, você pode usar o Cloud Console para criar ambientes ativos. Consulte Referência de CLI da nuvem.

Para clonar um ambiente master do projeto:

  1. Faça logon na estação de trabalho local com uma conta do proprietário do sistema de arquivos.

  2. Altere para o diretório do servidor Web ou host virtual docroot.

  3. Faça logon usando a CLI do magento-cloud.

    code language-bash 
    magento-cloud login

  4. Liste seus projetos.

    code language-bash 
    magento-cloud project:list

  5. Clonar um projeto.

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

    Quando solicitado, forneça um nome de diretório.

  6. Mude para o diretório magento2.

  7. Listar ambientes disponíveis para o projeto.

    code language-bash 
    magento-cloud environment:list
    note important
    IMPORTANT
    O comando magento-cloud environment:list exibe hierarquias de ambiente, enquanto o comando git branch não.

  8. Busque as ramificações remotas.

    code language-bash 
    git fetch origin

  9. Obter código atualizado.

    code language-bash 
    git pull origin <environment-ID>
TIP
Consulte Integrações para obter informações sobre como usar serviços de hospedagem baseados em Git com o Adobe Commerce na infraestrutura em nuvem.

Criar uma ramificação para desenvolvimento

Depois de clonar o projeto e atualizar a configuração da conta de administrador do Adobe Commerce, você pode ramificar para desenvolvimento. Como dito anteriormente, você deve criar um ambiente usando o comando magento-cloud environment:branch <branch-name> ou o Cloud Console para que o ambiente se torne ativo.

  • Para Início, considere criar uma ramificação para staging e, em seguida, crie uma ramificação de desenvolvimento com base na ramificação staging.
  • Para Pro, crie ramificações de desenvolvimento com base na ramificação Integration.

Para criar uma ramificação de desenvolvimento:

  1. Na estação de trabalho local, altere para o diretório do projeto.

  2. Crie um ambiente com base na ramificação recomendada para o fluxo de trabalho do projeto.

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

  3. Atualizar dependências.

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

  4. [opcional] Crie um backup do ambiente.

Mesclar uma ramificação

Após concluir o desenvolvimento, mescle esta ramificação com a principal:

  1. Confirmar e enviar alterações de código:

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

  2. Mesclar com o ambiente pai:

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

Excluir um ambiente

Exclua um ambiente somente se tiver certeza de que ele não é mais necessário. Não é possível recuperar um ambiente depois de excluí-lo.

WARNING
Você não pode excluir a ramificação master de nenhum projeto.

Você precisa ser um administrador de projeto, um administrador de ambiente ou um Proprietário da conta para executar esta tarefa. Consulte Gerenciar acesso de usuário a projetos na nuvem.

Ao excluir um ambiente, ele é definido como inativo. O código ainda está disponível na ramificação Git, mas não contém mais os serviços ou o banco de dados. Para excluir o ambiente completamente, você também deve excluir a ramificação Git remota correspondente.

Para excluir um ambiente:

  1. Na estação de trabalho local, altere para o diretório do projeto.

  2. Buscar atualizações do servidor remoto.

    code language-bash 
    git fetch

  3. Exclua a ramificação do ambiente.

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

    Como opção, é possível excluir mais de um ambiente de cada vez, adicionando várias IDs de ambiente ao comando de exclusão.

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

  4. Responda às solicitações para excluir o ambiente local e o ambiente remoto correspondente.

    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]

    A exclusão do ambiente o coloca em um estado inativo.

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

    Excluir a ramificação Git remota remove o ambiente do projeto.

  5. Aguarde a exclusão do ambiente.

    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.
TIP
Para ativar um ambiente inativo, use o comando magento-cloud environment:activate.

Interagir com ambientes remotos

Depois de configurar chaves SSH, você pode se conectar do espaço de trabalho local a um ambiente remoto e interagir com os serviços do projeto e modificar as configurações.

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