Cloud CLI
Lo strumento CLI magento-cloud
consente agli sviluppatori e agli amministratori di sistema di gestire progetti e ambienti Cloud, eseguire routine ed eseguire attività di automazione in locale. La CLI di magento-cloud
estende le funzionalità di Cloud Console. Dopo aver installato la CLI magento-cloud
sulla workstation locale, è possibile utilizzarla per gestire gli ambienti di integrazione Adobe Commerce on cloud infrastructure Starter e Pro.
Per installare magento-cloud
CLI:
-
Nella workstation locale, passa alla directory in cui intendi clonare il progetto Cloud e in cui il proprietario del file system dispone dell'accesso scrittura.
-
Installare l'interfaccia della riga di comando
magento-cloud
.code language-bash curl -sS https://accounts.magento.cloud/cli/installer | php
-
Aggiungere
magento-cloud
CLI al profilo Bash.code language-bash export PATH=$PATH:$HOME/.magento-cloud/bin
-
Ricarica il profilo di base aggiornato.
code language-bash . ~/.bash_profile
-
Per avviare CLI, chiamare
magento-cloud
e immettere le credenziali dell'account Cloud quando richiesto.code language-bash magento-cloud
code language-none Welcome to Magento Cloud! Please log in using your Magento Cloud account. Your email address or username:
-
Verificare che il comando
magento-cloud
sia presente nel percorso. Nell'esempio seguente vengono elencati i comandi disponibili.code language-bash magento-cloud list
Comandi comuni
Adobe ha progettato questi comandi per gestire gli ambienti di integrazione Cloud e consiglia di eseguire l'interfaccia CLI magento-cloud
da una directory di progetto in modo da poter omettere il parametro -p <project-ID>
.
Il seguente elenco di comandi CLI magento-cloud
comunemente utilizzati include solo le opzioni richieste. È possibile utilizzare l'opzione --help
con qualsiasi comando per visualizzare ulteriori informazioni.
magento-cloud login
magento-cloud list
magento-cloud environment:list
magento-cloud environment:checkout
magento-cloud environment:merge -e
magento-cloud variables
magento-cloud ssh
magento-cloud url
magento-cloud web
Comandi di ambiente
L'ambiente name è diverso dall'ambiente ID solo se si utilizzano spazi o lettere maiuscole nel nome dell'ambiente. Un ID ambiente è costituito da tutte le lettere minuscole, i numeri e i simboli consentiti. Le lettere maiuscole nel nome di un ambiente vengono convertite in minuscole nell’ID; gli spazi nel nome di un ambiente vengono convertiti in trattini.
Il nome di ambiente non può includere caratteri riservati per la shell Linux o per le espressioni regolari. I caratteri non consentiti includono parentesi graffe ({ }
), parentesi, asterisco (*
), parentesi angolari (< >
), e commerciale (&
), percentuale (%
) e altri caratteri.
Il comando magento-cloud environment:list
visualizza le gerarchie dell'ambiente, mentre git branch
no. Se disponi di ambienti nidificati, utilizza quanto segue:
magento-cloud environment:list
Ridistribuire l’ambiente
Attiva una ridistribuzione senza utilizzare un push. Verifica e conferma l’ambiente da ridistribuire. Non utilizzare la ridistribuzione se è presente una build in uno stato in sospeso.
magento-cloud environment:redeploy
Risposta di esempio:
Are you sure you want to redeploy the environment <environment-name>? [Y/n]
Comandi Git
È possibile notare che alcuni di questi comandi sono simili ai comandi Git. I comandi magento-cloud
si connettono direttamente al progetto Cloud basato su Git con funzionalità aggiuntive. Se si crea un ramo senza utilizzare l'interfaccia CLI di magento-cloud
, questo non viene "attivato" e non viene generato automaticamente quando si inviano le modifiche all'ambiente remoto. Il comando CLI magento-cloud
include l'attivazione.
Per creare un ramo, utilizzare il comando magento-cloud
in modo che il ramo venga attivato.
magento-cloud environment:branch <new-name> <parent-branch>
Per lo stato della filiale:
- Utilizza il comando
magento-cloud env
per visualizzare un elenco dei rami dell'ambiente e il loro stato: attivo o inattivo. - Utilizzare il comando
magento-cloud environment:activate
per attivare un ramo dell'ambiente.
Effettua il push di un commit Git vuoto per attivare una distribuzione. Ad esempio:
git commit --allow-empty -m "redeploy" && git push <branch-name>
Alcune azioni, come l’aggiunta di un utente, non comportano la distribuzione.
Creare un ramo dell’ambiente
I passaggi seguenti illustrano l’utilizzo dei comandi CLI e Git in modo intercambiabile per gestire l’ambiente locale:
-
Sulla workstation locale, passa alla directory del progetto.
-
Passa al proprietario del file system.
-
Accedi al progetto.
code language-bash magento-cloud login
-
Elencare i progetti.
code language-bash magento-cloud project:list
-
Elencare gli ambienti nel progetto. Ogni ambiente include un ramo Git attivo che contiene il codice, il database, le variabili di ambiente, le configurazioni e i servizi.
code language-bash magento-cloud environment:list
note note NOTE È importante utilizzare il comando magento-cloud environment:list
perché visualizza gerarchie di ambiente, mentre il comandogit branch
no. -
Recupera i rami di origine per ottenere il codice più recente.
code language-bash git fetch origin
-
Estrai o passa a un ramo e a un ambiente specifici.
code language-bash magento-cloud environment:checkout <environment-ID>
I comandi Git estraggono solo il ramo Git. Il comando
magento-cloud checkout
estrae il ramo e passa all'ambiente attivo.note tip TIP È possibile creare un ramo dell'ambiente utilizzando la sintassi del comando magento-cloud environment:branch <environment-name> <parent-environment-ID>
. La creazione e l’attivazione di un ramo dell’ambiente potrebbe richiedere un po’ di tempo. -
Utilizza l’ID dell’ambiente per richiamare il codice aggiornato nel tuo locale. Questo non è necessario se il ramo dell’ambiente è nuovo.
code language-bash git pull origin <environment-ID>
-
(Facoltativo) Crea uno snapshot dell'ambiente come backup.
code language-bash magento-cloud snapshot:create -e <environment-ID>
Aggiornare CLI
L'interfaccia della riga di comando magento-cloud
verifica la disponibilità di aggiornamenti al momento dell'accesso, ma è possibile verificare la disponibilità di aggiornamenti utilizzando il comando self:update
. Se è disponibile un aggiornamento, seguire le istruzioni per aggiornare CLI.
Se la CLI di magento-cloud
è aggiornata, viene visualizzata la seguente risposta:
magento-cloud update
Checking for Magento Cloud CLI updates (current version: X.XX.X)
No updates found