DocumentaçãoCommerceGuia do Commerce na infraestrutura em nuvem

Gerenciar ramificações com a CLI

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

Criado para:

  • Developer

Para instalar o magento-cloud CLI, consulte a seção Referência da CLI da nuvem. Depois de instalar o magento-cloud CLI e configurar chaves SSH para acesso remoto à sua infraestrutura em nuvem, você pode usar magento-cloud Comandos da CLI para gerenciar os ambientes de seus projetos. Para obter informações sobre a arquitetura do ambiente, consulte Arquitetura inicial 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

A variável magento-cloud Os comandos da CLI 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 a partir de um diretório de projeto, você pode omitir o -p <project-ID> parâmetro. Consulte a Referência da CLI da nuvem.

Clonar o projeto

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

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 magento-cloud environment:branch <branch-name> comando para que o ambiente se torne ativo. Como alternativa, você pode usar o Cloud Console para criar ambientes ativos. Consulte Referência da CLI da nuvem.

Para clonar um projeto master ambiente:

  1. Efetue login na sua estação de trabalho local com uma proprietário do sistema de arquivos conta.

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

  3. Fazer logon usando o magento-cloud CLI.

    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. Altere para a variável magento2 diretório.

  7. Listar ambientes disponíveis para o projeto.

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

  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 os 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. Conforme dito anteriormente, você deve criar um ambiente usando o magento-cloud environment:branch <branch-name> ou o comando Cloud Console para que o ambiente se torne ativo.

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

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] Criar 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
Não é possível excluir o master de qualquer projeto.

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

Quando você exclui 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-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]

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

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

Interagir com ambientes remotos

Depois que você configurar chaves SSH, você pode conectar-se 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