Gestire i rami con CLI

Per installare magento-cloud CLI, vedere Riferimento CLI cloud. Dopo aver installato magento-cloud e configurare le chiavi SSH per l'accesso remoto all'infrastruttura cloud, è possibile utilizzare magento-cloud Comandi CLI per gestire gli ambienti per i progetti. Per informazioni sull’architettura dell’ambiente, consulta Architettura iniziale o Architettura Pro.

Per gestire rami e ambienti con Cloud Console, vedi Gestire i rami con Cloud Console.

Utilizzare i comandi CLI

Il magento-cloud I comandi CLI sono simili ai comandi Git. Puoi utilizzarli per connetterti al progetto e gestire gli ambienti. Sebbene sia possibile eseguire i comandi da qualsiasi directory, si consiglia di eseguirli da una directory di progetto. Quando viene eseguito da una directory di progetto, è possibile omettere -p <project-ID> parametro. Consulta la Riferimento CLI cloud.

Clona il progetto

Le istruzioni seguenti utilizzano una combinazione di magento-cloud Comandi CLI e comandi Git per clonare il progetto sulla workstation locale. Per visualizzare un elenco completo di magento-cloud Comandi CLI, utilizzare magento-cloud list comando.

IMPORTANT
Alcuni comandi Git non possono completare un’azione nel progetto di infrastruttura cloud di Adobe Commerce. Ad esempio, puoi creare un ramo utilizzando un comando Git, ma non puoi creare e attivare un nuovo ambiente. È necessario creare un ambiente utilizzando magento-cloud environment:branch <branch-name> affinché l’ambiente diventi attivo. In alternativa, è possibile utilizzare Cloud Console per creare ambienti attivi. Consulta Riferimento CLI cloud.

Per clonare un progetto master ambiente:

  1. Accedere alla workstation locale con un proprietario del file system account.

  2. Passare al server web o all'host virtuale docroot directory.

  3. Accedi utilizzando magento-cloud CLI

    code language-bash
    magento-cloud login
    
  4. Elencare i progetti.

    code language-bash
    magento-cloud project:list
    
  5. Clona un progetto.

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

    Quando richiesto, fornisci un nome di directory.

  6. Cambia in magento2 directory.

  7. Elencare gli ambienti disponibili per il progetto.

    code language-bash
    magento-cloud environment:list
    
    note important
    IMPORTANT
    Il magento-cloud environment:list visualizza le gerarchie di ambiente, mentre il comando git branch il comando non.
  8. Recupera i rami remoti.

    code language-bash
    git fetch origin
    
  9. Recupera il codice aggiornato.

    code language-bash
    git pull origin <environment-ID>
    
TIP
Consulta Integrazioni per informazioni sull’utilizzo dei servizi di hosting basati su Git con Adobe Commerce sull’infrastruttura cloud.

Creare un ramo per lo sviluppo

Dopo aver clonato il progetto e aver aggiornato la configurazione dell’account amministratore di Adobe Commerce, puoi creare un ramo per lo sviluppo. Come indicato in precedenza, è necessario creare un ambiente utilizzando magento-cloud environment:branch <branch-name> comando o Cloud Console affinché l'ambiente diventi attivo.

  • Per Starter, è consigliabile creare un ramo per staging, quindi crea un ramo di sviluppo basato su staging filiale.
  • Per Pro, creare rami di sviluppo in base al Integration filiale.

Per creare un ramo di sviluppo:

  1. Sulla workstation locale, passa alla directory del progetto.

  2. Crea un ambiente basato sul ramo consigliato per il flusso di lavoro del progetto.

    code language-bash
    magento-cloud branch <new-environment-name> integration
    
  3. Aggiornare le dipendenze.

    code language-bash
    composer --no-ansi --no-interaction install --no-progress --prefer-dist --optimize-autoloader
    
  4. [facoltativo] Creare un backup dell'ambiente.

Unire un ramo

Dopo aver completato lo sviluppo, unisci questo ramo all’elemento padre:

  1. Modifiche al codice di commit e push:

    code language-bash
    git add -A && git commit -m "Add message here"
    
    code language-bash
    git push origin <branch-name>
    
  2. Unisci con l’ambiente principale:

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

Eliminare un ambiente

Elimina un ambiente solo se sei sicuro di non averne più bisogno. Non è possibile ripristinare un ambiente dopo averlo eliminato.

WARNING
Impossibile eliminare master di qualsiasi progetto.

Per eseguire questa attività è necessario essere un amministratore di progetto, un amministratore dell'ambiente o un proprietario account. Consulta Gestire l’accesso degli utenti ai progetti Cloud.

Quando elimini un ambiente, questo viene impostato su inattivo. Il codice è ancora disponibile nel ramo Git, ma non contiene più i servizi o il database. Per eliminare completamente l’ambiente, devi eliminare anche il ramo Git remoto corrispondente.

Per eliminare un ambiente:

  1. Sulla workstation locale, passa alla directory del progetto.

  2. Recupera gli aggiornamenti dal server remoto.

    code language-bash
    git fetch
    
  3. Elimina il ramo ambiente.

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

    Facoltativamente, è possibile eliminare più ambienti alla volta aggiungendo più ID ambiente al comando delete.

    code language-bash
    magento-cloud environment:delete <environment-1-ID> <environment-2-ID>
    
  4. Rispondere alle richieste di eliminazione dell'ambiente locale e dell'ambiente remoto corrispondente.

    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]
    

    L’eliminazione dell’ambiente lo inserisce in un inattivo stato.

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

    L’eliminazione del ramo Git remoto rimuove l’ambiente dal progetto.

  5. Attendi l’eliminazione dell’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
Per attivare un ambiente inattivo, utilizza magento-cloud environment:activate comando.

Interagire con gli ambienti remoti

Dopo di te configurare le chiavi SSH, è possibile connettersi dall’area di lavoro locale a un ambiente remoto e interagire con i servizi di progetto e modificare le impostazioni.

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