Hantera grenar med CLI

Installera magento-cloud CLI, se CLI-referens för molnet. När du har installerat magento-cloud CLI och konfigurera SSH-nycklar för fjärråtkomst till din molninfrastruktur kan du använda magento-cloud CLI-kommandon för att hantera projektmiljöer. Mer information om miljöarkitekturen finns i Startarkitektur eller Pro-arkitektur.

Hantera grenar och miljöer med Cloud Console, se Hantera grenar med Cloud Console.

Använda CLI-kommandon

The magento-cloud CLI-kommandon liknar Git-kommandon. Du kan använda dem för att ansluta till ditt projekt och hantera dina miljöer. Även om du kan köra kommandona från en katalog bör du köra dem från en projektkatalog. När du kör från en projektkatalog kan du utesluta -p <project-ID> parameter. Se CLI-referens för molnet.

Klona projektet

I följande instruktioner används en kombination av magento-cloud CLI-kommandon och Git-kommandon för att klona projektet till din lokala arbetsstation. Visa en fullständig lista över magento-cloud CLI-kommandon använder du magento-cloud list -kommando.

IMPORTANT
Vissa Git-kommandon kan inte slutföra en åtgärd i Adobe Commerce i ett molninfrastrukturprojekt. Du kan till exempel skapa en gren med ett Git-kommando, men du kan inte skapa och aktivera en ny miljö. Du måste skapa en miljö med magento-cloud environment:branch <branch-name> för att miljön ska bli aktiv. Du kan också använda Cloud Console för att skapa aktiva miljöer. Se CLI-referens för molnet.

Klona ett projekt master miljö:

  1. Logga in på din lokala arbetsstation med en ägare av filsystem konto.

  2. Byt till webbservern eller det virtuella värdsystemet docroot katalog.

  3. Logga in med magento-cloud CLI.

    code language-bash
    magento-cloud login
    
  4. Lista dina projekt.

    code language-bash
    magento-cloud project:list
    
  5. Klona ett projekt.

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

    Ange ett katalognamn när du uppmanas till detta.

  6. Ändra till magento2 katalog.

  7. Visa tillgängliga miljöer för projektet.

    code language-bash
    magento-cloud environment:list
    
    note important
    IMPORTANT
    The magento-cloud environment:list -kommandot visar systemhierarkier, medan git branch kommandot gör inte det.
  8. Hämta fjärrgrenarna.

    code language-bash
    git fetch origin
    
  9. Dra in uppdaterad kod.

    code language-bash
    git pull origin <environment-ID>
    
TIP
Se Integreringar om du vill ha information om hur du använder Git-baserade värdtjänster med Adobe Commerce om molninfrastruktur.

Skapa en gren för utveckling

När du har klonat projektet och uppdaterat Adobe Commerce administratörskonfiguration kan du skapa en gren för utvecklingen. Som tidigare nämnts måste du skapa en miljö med magento-cloud environment:branch <branch-name> kommandot eller Cloud Console för miljön aktiv.

  • För Starterkan du skapa en gren för stagingoch sedan skapa en utvecklingsgren baserat på staging gren.
  • För Pro, skapa utvecklingsgrenar baserat på Integration gren.

Skapa en utvecklingsgren:

  1. Byt till din projektkatalog på din lokala arbetsstation.

  2. Skapa en miljö baserad på den gren som rekommenderas för ditt projektarbetsflöde.

    code language-bash
    magento-cloud branch <new-environment-name> integration
    
  3. Uppdatera beroenden.

    code language-bash
    composer --no-ansi --no-interaction install --no-progress --prefer-dist --optimize-autoloader
    
  4. [valfri] Skapa en säkerhetskopia av miljön.

Sammanfoga en gren

När du är klar med utvecklingen sammanfogar du den här grenen med den överordnade:

  1. Verkställ och push-kodsändringar:

    code language-bash
    git add -A && git commit -m "Add message here"
    
    code language-bash
    git push origin <branch-name>
    
  2. Sammanfoga med den överordnade miljön:

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

Ta bort en miljö

Ta bara bort en miljö om du är säker på att du inte längre behöver den. Du kan inte återställa en miljö efter att du har tagit bort den.

WARNING
Du kan inte ta bort master del av ett projekt.

Du måste vara projektadministratör, miljöadministratör eller kontoägare för att kunna utföra den här åtgärden. Se Hantera användaråtkomst till molnprojekt.

När du tar bort en miljö ställs miljön in på inaktiv. Koden är fortfarande tillgänglig i Git-grenen, men innehåller inte längre tjänsterna eller databasen. Om du vill ta bort miljön helt måste du även ta bort motsvarande Git-fjärrgren.

Ta bort en miljö:

  1. Byt till din projektkatalog på din lokala arbetsstation.

  2. Hämta uppdateringar från fjärrservern.

    code language-bash
    git fetch
    
  3. Ta bort miljögrenen.

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

    Du kan också ta bort mer än en miljö åt gången genom att lägga till flera miljö-ID:n i kommandot delete.

    code language-bash
    magento-cloud environment:delete <environment-1-ID> <environment-2-ID>
    
  4. Svara på uppmaningarna att ta bort den lokala miljön och motsvarande fjärrmiljö.

    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]
    

    Om du tar bort miljön placeras den i en inaktiv tillstånd.

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

    Om du tar bort Git-fjärrgrenen tas miljön bort från projektet.

  5. Vänta tills miljön har tagits bort.

    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
Använd magento-cloud environment:activate -kommando.

Interagera med fjärrmiljöer

Efter dig konfigurera SSH-nycklarkan du ansluta från din lokala arbetsyta till en fjärrmiljö och interagera med projekttjänsterna och ändra inställningarna.

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