DocumentazioneCommerceGuida di Commerce su infrastruttura Cloud

Gestisci rami con Cloud Console

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Sviluppatore

È possibile gestire gli ambienti utilizzando Cloud Console o la CLI di magento-cloud. I file di progetto vengono memorizzati in un archivio Git. È possibile utilizzare i comandi Git per gestire il codice, ma la CLI di magento-cloud è progettata per interagire con le funzionalità della piattaforma, mentre i comandi Git non lo sono. Vedere Comandi Git nell'argomento CLI cloud.

In questo argomento viene illustrato come utilizzare Cloud Console per:

  • Aggiungere o eliminare un ambiente
  • Sincronizza (git pull) dall'ambiente padre
  • Unisci (git push) all'ambiente padre
TIP
Non è possibile creare rami dagli ambienti di staging e produzione di Pro. È possibile creare un branch dal branch master.

Creare un ambiente

La strategia di diramazione utilizza un flusso di lavoro Git comune in cui puoi sviluppare codice e aggiungere estensioni in un ramo di sviluppo. Consulta Starter e Pro panoramiche dell'architettura.

  • Per iniziare, crea un ramo staging dal ramo master, quindi un ramo da staging per lo sviluppo.
  • Per Pro, creare un ramo di sviluppo dall'ambiente Integration.

Il tuo account supporta un numero limitato di rami attivi {width="32"} (active) and an unlimited number of inactive branch {width="32"} (inattivi). Gestire i rami attivi e inattivi aggiungendo o eliminando un ramo utilizzando solo Cloud Console o Cloud CLI. Prima di eliminare un ramo, disattivalo, che rimane nell'elenco Ambienti come inattivo. Puoi riattivare il ramo in un secondo momento oppure eliminare il ramo nelle impostazioni dell'ambiente o utilizzando Cloud CLI.

Se hai bisogno di altri ambienti attivi per lo sviluppo, invia un ticket di supporto.

Per aggiungere un ramo:

  1. Accedi a Cloud Console.

  2. Selezionare un progetto dall'elenco Tutti i progetti.

  3. Seleziona un ambiente.

    note tip
    TIP
    Il nuovo ramo viene clonato da questo ambiente. Scegli un ambiente principale simile all’ambiente che stai per creare.

  4. Fare clic su Branch.

    Crea un ramo {width="150"}

  5. Nel modulo Diramazione da … immettere un nome di ramo.

    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.

  6. Selezionare un Environment type.

  7. Fare clic su Create Branch.

  8. Attendere. Distribuzione dell'ambiente in corso.

    Durante la distribuzione, lo stato dell'ambiente è In elaborazione. Dopo una distribuzione riuscita, lo stato diventa un segno di spunta verde per operazione riuscita.

Crea ramo inattivo

Non è possibile creare un ramo inattivo dalla console Adobe Commerce Cloud o da CLI. Se desideri creare un ramo inattivo, crealo nell’archivio Git e invialo tramite l’opzione environment.Parent sul comando.

git push -o "environment.Parent=<parent branch>" <origin> <branch>

Eliminare un ambiente

Prima di poter eliminare un ambiente, devi disattivarlo. Una volta che un ambiente è inattivo, puoi eliminarlo.

Per disattivare un ambiente:

  1. Accedi a Cloud Console.

  2. Selezionare un progetto dall'elenco Tutti i progetti.

  3. Selezionare l'ambiente dall'elenco della barra di spostamento Ambiente.

  4. Fai clic sull’icona Configura a destra della barra di navigazione superiore, che apre le impostazioni dell’ambiente.

  5. Nella scheda General ​scorrere verso il basso fino alla sezione​ Deactivate environment, fare clic su Deactivate environment and delete data e seguire le istruzioni.

Sincronizzare un ambiente

La sincronizzazione di un ambiente (o ramo) è uguale a git pull origin <parent>. Puoi sincronizzare il codice aggiornato da un ambiente principale. È possibile utilizzare questa funzionalità tramite Cloud Console per tutti gli ambienti Starter e Pro.

Per il piano Pro, puoi sincronizzare da Staging e Produzione al tuo ramo master. Questa sincronizzazione richiama e invia solo codice, non dati. Per sincronizzare i dati, scarica i dati del database e inviali al database di un altro ambiente. Vedi Eseguire la migrazione e distribuire file e dati statici.

Per sincronizzare un ambiente:

  1. Accedi a Cloud Console.

  2. Selezionare un progetto dall'elenco Tutti i progetti.

  3. Nell'elenco Ambiente fare clic sul nome del ramo da sincronizzare.

  4. Fai clic su (sincronizza).

    Sincronizza un ambiente {width="150"}

  5. Selezionare gli elementi da sincronizzare.

    • Sostituisci i dati: (dati e file) sincronizza le modifiche nel database e nei file di contenuto dal ramo padre.
    • Unisci—(code) sincronizza il codice aggiornato dal ramo padre.

    Viene inoltre creato un comando CLI da copiare e utilizzare.

  6. Fare clic su Sincronizza.

Unisci con ambiente padre

L'unione di un ambiente (o ramo) è uguale a git push origin. Unisci per inviare il codice aggiornato da un ambiente al relativo ambiente principale. È possibile unire questo codice a master. È possibile distribuire a Staging e Produzione utilizzando il comando merge.

Per eseguire l'unione con l'ambiente padre:

  1. Accedi a Cloud Console.

  2. Selezionare un progetto dall'elenco Tutti i progetti.

  3. Nell’elenco dell’ambiente, fai clic sul nome del ramo da unire.

  4. Fai clic su (unisci).

    Unire un ambiente {width="150"}

  5. Fai clic su Unisci e conferma l'azione.

Visualizzare i registri

Tramite Cloud Console è possibile esaminare vari registri per gli ambienti, inclusa la cronologia di compilazione, distribuzione e distribuzione.

Per Starter, puoi rivedere i registri di compilazione e distribuzione e la cronologia di distribuzione. Questi ambienti includono il ramo master (Produzione) e tutti i rami creati da esso.

Per Pro, puoi rivedere i seguenti registri in ogni ambiente:

  • Integrazione: creazione, distribuzione e cronologia di distribuzione
  • Staging: creazione di registri e cronologia di distribuzione. Utilizza SSH per accedere al server e visualizzare i registri di distribuzione.
  • Produzione: creazione di registri e cronologia di distribuzione. Utilizza SSH per accedere al server e visualizzare i registri di distribuzione.

Per visualizzare i registri inCloud Console:

  1. Accedi a Cloud Console.

  2. Selezionare un progetto dall'elenco Tutti i progetti.

  3. Seleziona un ambiente.

    La visualizzazione dell'ambiente fornisce un elenco attività che mostra eventi recenti, una voce per azione tentata tra cui sincronizzazioni, unioni, rami, backup e altro ancora. Fare clic su Tutti per visualizzare la cronologia completa della distribuzione.

  4. Per visualizzare il registro della build, seleziona il collegamento Riuscito o Non riuscito per record di distribuzione sull’account.

TIP
Fai clic sull'icona Filtra per per un elenco a discesa e seleziona il tipo di messaggi da visualizzare.

Estrarre il codice da un archivio Git privato

Il progetto Adobe Commerce su infrastruttura cloud può includere il codice da un archivio Git privato. Ad esempio, puoi avere il codice per un modulo personalizzato o un tema in un archivio privato. Per eseguire questa operazione, devi aggiungere la chiave SSH pubblica del progetto all'archivio Git privato e aggiornare il file di progetto composer.json.

Per aggiungere una chiave di distribuzione all’archivio GitHub privato, devi essere l’amministratore di tale archivio. GitHub consente di utilizzare una chiave di distribuzione per un solo archivio.

Se preferisci che il progetto acceda a più archivi, puoi allegare una chiave SSH a un account utente automatizzato. Poiché questo account non è utilizzato da un utente umano, viene indicato come utente computer. Aggiungi l’account computer come collaboratore o aggiungi l’utente computer a un team con accesso agli archivi.

INFO
L’Adobe consiglia di aggiungere e unire questo codice agli archivi Git del progetto. Se non configuri la connessione, potrebbero verificarsi problemi di build.

Per trovare la chiave pubblica SSH:

  1. Accedi a Cloud Console.

  2. Selezionare un progetto dall'elenco Tutti i progetti.

  3. Fai clic sull’icona di configurazione a destra della barra di navigazione superiore.

  4. In Impostazioni progetto, fare clic su Deploy Key.

  5. Copia la chiave di distribuzione negli Appunti per l’utilizzo in uno dei seguenti metodi basati su Git:

GitHub

Immetti la chiave di distribuzione GitHub

Su GitHub, le chiavi di distribuzione sono di sola lettura per impostazione predefinita.

Per immettere la chiave pubblica del progetto come chiave di distribuzione GitHub:

  1. Accedi all’archivio GitHub come amministratore.

  2. Fare clic sulla scheda del repository Settings.

    note note
    NOTE
    Se questa opzione non è disponibile, non si è connessi come amministratore del repository e non è possibile completare l'attività. Chiedi all’amministratore dell’archivio GitHub di eseguire questa operazione.

  3. Nella scheda Impostazioni della barra di navigazione a sinistra, fare clic su Deploy Keys.

  4. Fare clic su Add deploy key.

  5. Seguire le istruzioni.

In composer.json, utilizzare il formato <user>@<host>:<.git</code> o ssh://<user>@<host>:<port>/<path>.git se si utilizza una porta non standard.

Bitbucket

Immetti la chiave di distribuzione Bitbucket

Per immettere la chiave pubblica del progetto come chiave di distribuzione Bitbucket:

  1. Accedi all’archivio Bitbucket come amministratore.

  2. Nel menu di navigazione a sinistra, fare clic su Settings.

  3. Fare clic su Generale > Deployment Keys.

  4. Fare clic su Add Key.

  5. Seguire le istruzioni.

GitLab

Immetti la chiave di distribuzione GitLab

Per aggiungere la chiave SSH pubblica per il progetto come chiave di distribuzione GitLab:

  1. Accedi all’archivio GitLab come proprietario.

  2. Verifica che l'opzione Pipeline sia abilitata per il progetto:

    1. Nelle impostazioni del progetto, espandi la sezione Visibility, project, features, permissions.
    2. Se necessario, fare clic su Pipelines per abilitare l'opzione.

  3. Aggiungi la chiave SSH pubblica alle impostazioni CI/CD.

    1. Nel menu di navigazione a sinistra, fare clic su Impostazioni > CI / CD.
    2. Fai clic su Distribuisci chiavi Espandi per configurare la chiave.
    3. Nel modulo Distribuisci chiave, aggiungi un nome di chiave di distribuzione al campo Title e incolla la chiave SSH pubblica nel campo Key.
    4. Fare clic su Add Key per salvare la configurazione.

Ambienti e rami sicuri

È possibile accedere al progetto e agli ambienti da qualsiasi posizione tramite un browser Web utilizzando Cloud Console. È possibile che sia stata impostata la protezione per l'ambiente di produzione, gli archivi e i siti. Questa sezione ti aiuta a proteggere gli ambienti di integrazione e staging per i tuoi sviluppatori, DBA e altro ancora.

WARNING
DO NOT utilizza i seguenti metodi per proteggere gli ambienti di staging e produzione Pro. Questo interrompe il caching rapido. Utilizza la funzionalità Blocco disponibile nella rete CDN Fastly per Adobe Commerce.

Per proteggere gli ambienti:

  1. Accedi a Cloud Console.

  2. Selezionare un progetto dall'elenco Tutti i progetti.

  3. Seleziona un ambiente e fai clic sull’icona di configurazione nella barra di navigazione.

  4. Nella scheda Impostazioni ambiente Generale, fare clic su SU per HTTP access control enabled per abilitare l'accesso protetto. Puoi scegliere tra credenziali o indirizzi IP per filtrare l’accesso.

  5. Per filtrare in base alle credenziali, fare clic su Add Login, immettere un nome utente e una password, quindi fare clic su Add Login per aggiungere.

  6. Per filtrare per indirizzo IP, immettere gli indirizzi IP in un elenco con deny o allow. Ad esempio:

    code language-text 
    123.456.789.111/29 allow
123.456.789.112/29 allow
234.123.567.111/29 allow
0.0.0.0/0 deny

  7. Fare clic su Save. In questo modo l’ambiente viene ridistribuito per aggiornare la sicurezza e le impostazioni. L’Adobe consiglia di eseguire un test dell’ambiente dopo aver completato le impostazioni di sicurezza.

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