DokumentationHandelAnvändarhandbok om Commerce i molninfrastrukturen

Hantera grenar med Cloud Console

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

Skapat för:

  • Utvecklare

Du kan hantera dina miljöer med Cloud Console eller magento-cloud CLI. Dina projektfiler lagras i en Git-databas. Du kan använda Git-kommandon för att hantera koden, men CLI:n för magento-cloud är utformad för att interagera med plattformsfunktioner, vilket Git-kommandona inte gör. Se Git-kommandon i CLI-avsnittet i molnet.

I det här avsnittet beskrivs hur du använder Cloud Console för att:

  • Lägga till eller ta bort en miljö
  • Synkronisera (git pull) från den överordnade miljön
  • Koppla (git push) till den överordnade miljön
TIP
Du kan inte skapa grenar från Pro Staging- och Production-miljöer. Du kan förgrena från grenen master.

Skapa en miljö

Förgreningsstrategin använder ett gemensamt Git-arbetsflöde där du utvecklar kod och lägger till tillägg i en utvecklingsgren. Se Starter och Pro - översikter över arkitekturen.

  • För Starter skapar du en staging-gren från grenen master och sedan grenar från staging för utveckling.
  • Skapa en utvecklingsgren från miljön Integration för Pro.

Ditt konto har stöd för ett begränsat antal aktiva grenar {width="32"} (active) and an unlimited number of inactive branch {width="32"} (inaktiva) utvecklingsgrenar. Hantera aktiva och inaktiva grenar genom att lägga till eller ta bort en gren med endast Cloud Console eller molnbaserad CLI. Innan du kan ta bort en gren inaktiverar du grenen, som finns kvar i listan Miljöer som inaktiv. Du kan återaktivera grenen senare eller så kan du ta bort grenen i miljöinställningarna eller använda molnet-CLI.

Om du behöver ytterligare aktiva miljöer för utveckling skickar du en supportanmälan.

Lägga till en gren:

  1. Logga in på Cloud Console.

  2. Välj ett projekt i listan Alla projekt.

  3. Välj en miljö.

    note tip
    TIP
    Din nya gren klonas från den här miljön. Välj en överordnad miljö som liknar den miljö du ska skapa.

  4. Klicka på Branch.

    Skapa en gren {width="150"}

  5. I formuläret Förgreningar från … anger du ett förgreningsnamn.

    Miljön name skiljer sig bara från miljön ID om du använder blanksteg eller versaler i miljönamnet. Ett miljö-ID består av alla gemener, siffror och tillåtna symboler. Versaler i ett miljönamn konverteras till gemener i ID:t. Blanksteg i ett miljönamn konverteras till streck.

    Miljönamnet får inte innehålla tecken som är reserverade för ditt Linux-skal eller för reguljära uttryck. Otillåtna tecken är klammerparenteser ({ }), parenteser, asterisk (*), vinkelparenteser (>), et-tecken (&), procent (%)) och andra tecken.

  6. Välj en Environment type.

  7. Klicka på Create Branch.

  8. Vänta medan miljön distribueras.

    Under distributionen är miljöstatusen Pågår. När distributionen är klar ändras statusen till en grön bock för success.

Skapa inaktiv gren

Du kan inte skapa en inaktiv gren från Adobe Commerce Cloud-konsolen eller CLI. Om du vill skapa en inaktiv gren skapar du den i Git-databasen och skickar den med alternativet environment.Parent i kommandot.

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

Ta bort en miljö

Innan du kan ta bort en miljö måste du inaktivera den. När en miljö är inaktiv kan du ta bort den.

Så här inaktiverar du en miljö:

  1. Logga in på Cloud Console.

  2. Välj ett projekt i listan Alla projekt.

  3. Välj miljö i listan Miljö i navigeringsfältet.

  4. Klicka på konfigurationsikonen till höger i det övre navigeringsfältet, som öppnar miljöinställningarna.

  5. Bläddra nedåt till avsnittet Deactivate environment ​på fliken​ General, klicka på Deactivate environment and delete data och följ instruktionerna.

Synkronisera en miljö

Synkronisering av en miljö (eller gren) är samma som git pull origin <parent>. Du kan synkronisera uppdaterad kod från en överordnad miljö. Du kan använda den här funktionen via Cloud Console för alla Starter- och Pro-miljöer.

För Pro-planen kan du synkronisera från mellanlagring och produktion till din master-gren. Synkroniseringen hämtar och push-tar bara fram kod, inte data. Om du vill synkronisera data dumpar du databasdata och överför dem till en annan miljös databas. Se Migrera och distribuera statiska filer och data.

Synkronisera en miljö:

  1. Logga in på Cloud Console.

  2. Välj ett projekt i listan Alla projekt.

  3. Klicka på namnet på grenen som ska synkroniseras i miljölistan.

  4. Klicka på (synkronisera).

    Synkronisera en miljö {width="150"}

  5. Markera de objekt som ska synkroniseras.

    • Ersätt data (data och filer) synkroniserar ändringar i databasen och innehållsfilerna från den överordnade grenen.
    • Sammanfoga - (kod) synkroniserar uppdaterad kod från den överordnade grenen.

    Detta skapar också ett CLI-kommando som du kan kopiera och använda.

  6. Klicka på Synkronisera.

Sammanfoga med överordnad miljö

Sammanfogning av en miljö (eller gren) är samma som git push origin. Du sammanfogar för att skicka uppdaterad kod från en miljö till dess överordnade miljö. Du kan sammanfoga koden med master. Du kan distribuera till mellanlagring och produktion med kommandot merge.

Så här sammanfogar du med den överordnade miljön:

  1. Logga in på Cloud Console.

  2. Välj ett projekt i listan Alla projekt.

  3. Klicka på namnet på grenen som ska sammanfogas i miljölistan.

  4. Klicka på (sammanfoga).

    Sammanfoga en miljö {width="150"}

  5. Klicka på Sammanfoga och bekräfta åtgärden.

Visa loggar

Genom Cloud Console kan du granska olika loggar för miljöer, inklusive historik för bygge, distribution och distribution.

För Starter kan du granska bygg- och distributionsloggar och distributionshistoriken. De här miljöerna innehåller grenen master (produktion) och alla grenar som skapats av den.

För Pro kan du granska följande loggar i varje miljö:

  • Integration - Skapa, driftsätt och driftsättningshistorik
  • Mellanlagring - Bygg loggar och driftsättningshistorik. Använd SSH för att logga in på servern för att visa distributionsloggar.
  • Produktion - Bygg loggar och driftsättningshistorik. Använd SSH för att logga in på servern för att visa distributionsloggar.

Så här visar du loggar iCloud Console:

  1. Logga in på Cloud Console.

  2. Välj ett projekt i listan Alla projekt.

  3. Välj en miljö.

    Miljövyn innehåller en aktivitetslista som visar senaste händelser, en post per åtgärd som gjorts, inklusive synkroniseringar, sammanfogningar, grenar, säkerhetskopieringar med mera. Klicka på Alla om du vill se den fullständiga distributionshistoriken.

  4. Om du vill visa byggloggen väljer du länken Slutfört eller Fel per distributionspost på kontot.

TIP
Klicka på ikonen Filtrera efter för en nedrullningsbar lista och välj den typ av meddelanden som ska visas.

Hämta kod från en privat Git-databas

Ditt Adobe Commerce i molninfrastrukturprojekt kan innehålla kod från en privat Git-databas. Du kan till exempel ha kod för en anpassad modul eller tema i en privat rapport. Om du vill göra det måste du lägga till projektets offentliga SSH-nyckel i din privata Git-databas och uppdatera projektfilen composer.json.

Om du vill lägga till en distributionsnyckel i din privata GitHub-databas måste du vara administratör för den databasen. Med GitHub kan du bara använda en distributionsnyckel för en databas.

Om du föredrar att ditt projekt har åtkomst till flera databaser kan du bifoga en SSH-nyckel till ett automatiskt användarkonto. Eftersom det här kontot inte används av en människa kallas det för en datoranvändare. Lägg till datorkontot som medarbetare eller lägg till datoranvändaren i ett team med åtkomst till databaserna.

INFO
Adobe rekommenderar att du lägger till och sammanfogar den här koden i dina Git-projektdatabaser. Om du inte konfigurerar anslutningen kan du få problem med bygget.

Så här hittar du den offentliga SSH-nyckeln:

  1. Logga in på Cloud Console.

  2. Välj ett projekt i listan Alla projekt.

  3. Klicka på konfigurationsikonen till höger i det övre navigeringsfältet.

  4. Klicka på Deploy Key i Projektinställningar.

  5. Kopiera distributionsnyckeln till Urklipp och använd den på något av följande Git-baserade sätt:

GitHub

Ange din GitHub-distributionsnyckel

På GitHub är distributionsnycklar skrivskyddade som standard.

Så här anger du din offentliga projektnyckel som en GitHub-distributionsnyckel:

  1. Logga in som administratör i din GitHub-databas.

  2. Klicka på fliken Settings i databasen.

    note note
    NOTE
    Om du inte ser det här alternativet är du inte inloggad som databasadministratör och du kan inte slutföra den här uppgiften. Be din GitHub-databasadministratör att göra detta.

  3. Klicka på Deploy Keys på fliken Inställningar i den vänstra navigeringen.

  4. Klicka på Add deploy key.

  5. Följ anvisningarna.

Använd formatet <user>@<host>:<.git</code> i composer.json eller ssh://<user>@<host>:<port>/<path>.git om du använder en port som inte är standard.

Bitbucket

Ange en distributionsnyckel för Bitbucket

Så här anger du projektets offentliga nyckel som en Bitbucket-distributionsnyckel:

  1. Logga in som administratör i Bitbucket-databasen.

  2. Klicka på Settings i den vänstra navigeringen.

  3. Klicka på Allmänt > Deployment Keys.

  4. Klicka på Add Key.

  5. Följ anvisningarna.

GitLab

Ange din GitLab-distributionsnyckel

Så här lägger du till den offentliga SSH-nyckeln för ditt projekt som en GitLab-distributionsnyckel:

  1. Logga in som ägare i din GitLab-databas.

  2. Kontrollera att alternativet Pipelines är aktiverat för ditt projekt:

    1. Utöka avsnittet Visibility, project, features, permissions i projektinställningarna.
    2. Om det behövs klickar du på Pipelines för att aktivera alternativet.

  3. Lägg till den offentliga SSH-nyckeln i CI/CD-inställningarna.

    1. Klicka på Inställningar > CI / CD i den vänstra navigeringen.
    2. Klicka på Distribuera nycklar Utöka för att konfigurera nyckeln.
    3. I formuläret Distribuera nyckel lägger du till ett distribueringsnyckelnamn i fältet Title och klistrar in den offentliga SSH-nyckeln i fältet Key.
    4. Klicka på Add Key för att spara konfigurationen.

Säkra miljöer och grenar

Du kan komma åt ditt projekt och dina miljöer från vilken plats som helst via en webbläsare med hjälp av Cloud Console. Du kan ha säkerhetsinställningar för din produktionsmiljö, dina butiker och webbplatser. I det här avsnittet får du hjälp att skydda integrerings- och mellanlagringsmiljöer för enbart utvecklare, DBA:er med mera.

WARNING
Använd INTE följande metoder för att skydda Pro Staging- och Production-miljöer. Det här avbryter cachelagring. Använd funktionen Blockering som finns i snabbnätverket för CDN för Adobe Commerce.

För säkra miljöer:

  1. Logga in på Cloud Console.

  2. Välj ett projekt i listan Alla projekt.

  3. Välj en miljö och klicka på konfigurationsikonen i navigeringsfältet.

  4. På fliken Allmänt i miljöinställningarna klickar du på PÅ för HTTP access control enabled för att aktivera säker åtkomst. Du kan välja mellan autentiseringsuppgifter och IP-adresser att filtrera för åtkomst.

  5. Om du vill filtrera efter autentiseringsuppgifter klickar du på Add Login, anger ett användarnamn och lösenord och klickar på Add Login för att lägga till.

  6. Om du vill filtrera efter IP-adress anger du IP-adresserna i en lista med deny eller allow. Exempel:

    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. Klicka på Save. Miljön distribueras om för att uppdatera säkerhet och inställningar. Adobe rekommenderar att du testar miljön när du har slutfört säkerhetsinställningarna.

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