Gestire i rami con CLI

Per installare l'interfaccia della riga di comando magento-cloud, vedere il riferimento all'interfaccia della riga di comando Cloud. Dopo aver installato la CLI magento-cloud e aver impostato le chiavi SSH per l'accesso remoto all'infrastruttura cloud, è possibile utilizzare i comandi CLI magento-cloud per gestire gli ambienti per i progetti. Per informazioni sull'architettura dell'ambiente, vedere Architettura Starter o Architettura Pro.

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

Utilizzare i comandi CLI

I comandi CLI magento-cloud 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 il parametro -p <project-ID>. Vedere il riferimento a Cloud CLI.

Clona il progetto

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

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 il comando magento-cloud environment:branch <branch-name> affinché diventi attivo. In alternativa, è possibile utilizzare Cloud Console per creare ambienti attivi. Vedi Riferimento CLI cloud.

Per clonare un ambiente master del progetto:

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

  2. Passare alla directory docroot del server Web o dell'host virtuale.

  3. Accedere utilizzando l'interfaccia della riga di comando magento-cloud.

    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. Passare alla directory magento2.

  7. Elencare gli ambienti disponibili per il progetto.

    code language-bash
    magento-cloud environment:list
    
    note important
    IMPORTANT
    Il comando magento-cloud environment:list visualizza le gerarchie dell'ambiente, mentre il comando git branch no.
  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 il comando magento-cloud environment:branch <branch-name> o Cloud Console affinché l'ambiente diventi attivo.

  • Per Starter, provare a creare un ramo per staging, quindi creare un ramo di sviluppo basato sul ramo staging.
  • Per Pro, crea rami di sviluppo in base al ramo Integration.

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] Crea 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 il ramo 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 si elimina 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]
    

    Se si elimina l'ambiente, questo si trova nello stato inattivo.

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

Interagire con gli ambienti remoti

Dopo aver configurato le chiavi SSH, è possibile connettersi dall'area di lavoro locale a un ambiente remoto e interagire con i servizi del progetto e modificare le impostazioni.

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