Koddistribution

Senast uppdaterad: 5 maj 2025

Skapat för:

  • Administratör

Lär dig hur du distribuerar kod och vad som händer i Cloud Manager när du gör det.

Distribuera kod med Cloud Manager

När du har konfigurerat produktionsflödet, inklusive de nödvändiga databaserna och miljöerna, är du redo att distribuera koden.

  1. Klicka på Distribuera från Cloud Manager för att starta distributionsprocessen.

    Knappen Distribuera

  2. Skärmen Pipeline Execution visas. Klicka på Skapa för att starta processen.

    Knappen Skapa

Byggprocessen startar koddistributionsprocessen med följande steg:

  • Scendistribution
  • Stage testing
  • Produktionsdistribution

Du kan granska stegen från olika distributionsprocesser genom att visa loggar eller granska resultaten för testvillkoren.

Distributionssteg

Ett antal åtgärder inträffar under varje steg i distributionen, vilket beskrivs i det här avsnittet. Mer teknisk information om hur själva koden distribueras bakom scenerna finns i Information om distributionsprocess .

Steg för driftsättning

Steg Scendistribution innehåller följande åtgärder:

  • Validering: Detta steg säkerställer att pipeline är konfigurerad att använda de tillgängliga resurserna. Till exempel att den konfigurerade grenen finns och att miljöerna är tillgängliga.
  • Build & Unit Testing: Det här steget kör en innehållsstyrd byggprocess. Mer information finns i Build Environment.
  • Kodsökning: I det här steget utvärderas kvaliteten på programkoden. Mer information om testprocessen finns i Förstå testresultat.
  • Distribuera till scenen

Scendistribution

Steg för testning

Scentestningen omfattar följande åtgärder:

  • Säkerhetstestning: I det här steget utvärderas hur säkerhetseffekten av koden påverkar AEM. Mer information om testprocessen finns i dokumentet Förstå testresultat.
    • Prestandatestning: I det här steget utvärderas kodens prestanda. Mer information om testprocessen finns i Förstå testresultat.

Distributionssteg för produktion

Steget Produktionsdistribution innehåller följande åtgärder:

  • Ansökan om godkännande

    • Det här alternativet aktiveras när pipeline konfigureras.
    • Med det här alternativet kan du antingen schemalägga din produktionsdistribution eller klicka på nu för att köra produktionsdistributionen direkt.

  • Schemalägg produktionsdistribution

    • Det här alternativet aktiveras när pipeline konfigureras.

    • Det schemalagda datumet och den schemalagda tiden anges i användarens tidszon.

      Schemalägg distribution

  • CSE-stöd (om aktiverat)

  • Distribuera till produktion

Produktionsdistribution

När distributionen är klar finns koden i målmiljön och du kan visa loggarna.

Distributionen har slutförts

Timeout

Följande steg gör timeout om du väntar på användarfeedback:

StegTimeout
Testning av kodkvalitet7 dagar
Säkerhetstestning7 dagar
Prestandatestning7 dagar
Ansökan om godkännande (steg)7 dagar
Ansökan om godkännande (produktion)14 dagar
Schemalägg produktionsdistribution14 dagar
Hanterad produktionsdistribution14 dagar

Information om distributionsprocess

Cloud Manager överför alla mål-/*.zip-filer som skapas i byggprocessen till en lagringsplats. Dessa artefakter hämtas från den här platsen under pipelinens distributionsfaser.

När Cloud Manager använder icke-produktionstopologier är målet att slutföra distributionen så snabbt som möjligt och artefakterna distribueras därför på alla noder samtidigt enligt följande:

  1. Cloud Manager avgör om varje artefakt är ett AEM- eller Dispatcher-paket.

  2. Cloud Manager tar bort alla utskickare från belastningsutjämnaren för att isolera miljön under distributionen.

    • Om inget annat anges kan du hoppa över ändringar i belastningsutjämnaren i distributionen av utveckling och testning. Det vill säga, när det gäller utvecklingsmiljön, frigöra och knyta ihop steg i både icke-produktionsrörledningar och för mellanlagringsmiljön i produktionsflödet.

    Hoppa över belastningsutjämnare

    OBSERVERA
    1-1-1-1-kunder förväntas använda den här funktionen.

  3. Varje AEM-artefakt distribueras till varje AEM-instans via API:er för Package Manager, där paketberoenden avgör distributionsordningen.

    • Läs mer om hur du kan använda paket för att installera nya funktioner, överföra innehåll mellan instanser och säkerhetskopiera databasinnehåll. Se Package Manager.
    OBSERVERA
    Alla AEM artefakter distribueras till både författaren och utgivaren. Körningslägena bör utnyttjas när nodspecifika konfigurationer krävs. Om du vill veta mer om hur körningslägena gör att du kan trimma AEM för ett visst ändamål kan du läsa avsnittet Körningslägen i dokumentet Distribuera till AEM as a Cloud Service.

  4. Dispatcher-artefakten distribueras till alla Dispatcher enligt följande:

    1. Aktuella konfigurationer säkerhetskopieras och kopieras till en tillfällig plats.
    2. Alla konfigurationer tas bort utom de oföränderliga filerna. Mer information finns i Dispatcher Configurations. På så sätt rensas katalogerna så att inga överblivna filer lämnas kvar.
    3. Artefakten extraheras till katalogen httpd. Oändringsbara filer skrivs inte över. Alla ändringar du gör i oföränderliga filer i Git-databasen ignoreras vid distributionen. Dessa filer är viktiga för AMS Dispatcher-ramverket och kan inte ändras.
    4. Apache utför ett konfigurationstest. Om inga fel hittas läses tjänsten in igen. Om ett fel inträffar återställs konfigurationerna från en säkerhetskopia, tjänsten läses in igen och felet rapporteras tillbaka till Cloud Manager.
    5. Alla sökvägar som anges i pipeline-konfigurationen görs ogiltiga eller tömda från Dispatcher-cachen.
    OBSERVERA
    Cloud Manager förväntar sig att Dispatcher-artefakten ska innehålla hela filuppsättningen. Alla Dispatcher-konfigurationsfiler måste finnas i Git-databasen. Saknade filer eller mappar leder till distributionsfel.

  5. När alla AEM- och Dispatcher-paket har distribuerats till alla noder läggs de som skickar paketen tillbaka till belastningsutjämnaren och distributionen är klar.

    OBSERVERA
    Du kan hoppa över ändringar av belastningsutjämnare i utveckling och mellanlagringsdistributioner. Det vill säga, när det gäller utvecklingsmiljön, frigöra och knyt ihop steg i både icke-produktionsrörledningar och för mellanlagringsmiljön i produktionsflödet.

Distribution till produktionsfas

Processen för att distribuera till produktionstopologier skiljer sig något för att minimera påverkan för AEM besökare.

Produktionsinstallationer följer i allmänhet samma steg som ovan, men på ett rullande sätt:

  1. Distribuera AEM som ska författas.
  2. Koppla loss dispatcher1 från belastningsutjämnaren.
  3. Distribuera AEM paket för att publicera1 och Dispatcher-paketet för att skicka1 parallellt, tömma Dispatcher-cachen.
  4. Placera dispatcher1 i belastningsutjämnaren igen.
  5. När dispatcher1 är tillbaka i tjänst frigör du dispatcher2 från belastningsutjämnaren.
  6. Distribuera AEM paket för att publicera2 och Dispatcher-paketet till dispatcher2 parallellt, tömma Dispatcher-cachen.
  7. Placera dispatcher2 i belastningsutjämnaren igen.

Den här processen fortsätter tills distributionen har nått alla utgivare och utgivare i topologin.

Körningsläge för nödrörledning

I kritiska situationer kan Adobe Managed Services-kunder behöva driftsätta kodändringar direkt i sina scen- och produktionsmiljöer. Detta gör att de kan kringgå hela Cloud Manager testcykel.

För att åtgärda dessa situationer kan Cloud Manager produktionsflöde genomföras i nödläge. När det här läget används utförs inte stegen för säkerhets- och prestandatestning. Alla andra steg, inklusive konfigurerade godkännandesteg, körs som i det normala körningsläget för pipeline.

OBSERVERA
Funktionen för driftsättning av nödpipeline aktiveras program för program. Aktiveringen görs av Customer Success Engineers.

Använd körningsläge för nödsituationer

När du startar en körning av en produktionspipeline kan du välja mellan normalt läge eller nödläge i en dialogruta. Det här alternativet är tillgängligt om funktionen för körning av nödpipeline är aktiverad för programmet. Det här alternativet är tillgängligt när funktionen är aktiverad.

Kör pipeline-alternativ

När du visar informationssidan om pipelinekörning för en körning i nödläge visar de synliga kolumnerna högst upp på skärmen en indikation på att pipelinen körs i nödläge.

Felmeddelanden i nödläge

Körning av en pipeline i nödläge kan också göras via Cloud Manager API eller CLI. Om du vill starta en körning i nödläge skickar du en PUT-begäran till pipelinens körningsslutpunkt med frågeparametern ?pipelineExecutionMode=EMERGENCY eller, när CLI används:

$ aio cloudmanager:pipeline:create-execution PIPELINE_ID --emergency

Köra om en produktionsdistribution

I sällsynta fall kan produktionsdistributionsstegen misslyckas av tillfälliga orsaker. I dessa fall kan du köra produktionsdistributionssteget igen så länge det har slutförts, oavsett om det lyckades, avbröts eller misslyckades. Återkörning stöds genom att använda samma pipeline som består av följande tre steg:

  1. Valideringssteget - Samma validering som sker under en normal pipeline-körning.
  2. Byggsteget - I samband med en omkörning kopierar byggsteget artefakter och utför inte någon ny byggprocess.
  3. Produktionsdistributionssteget - Använder samma konfiguration och alternativ som produktionsdistributionssteget i en normal pipeline-körning.

I sådana fall där en omkörning är möjlig visas statussidan för produktionsflödet med alternativet Kör om bredvid det vanliga alternativet Hämta bygglogg.

Alternativet Kör igen i översiktsfönstret för pipeline

OBSERVERA
I en omkörning markeras byggsteget i användargränssnittet för att reflektera att det är kopieringsartefakter och inte återskapande.