Lägg till en produktionspipeline configure-production-pipeline

Lär dig hur du konfigurerar produktionspipelines för att skapa och distribuera kod till produktionsmiljöer. En produktionspipeline distribuerar kod först till scenmiljön. Vid godkännande distribueras samma kod till produktionsmiljön.

En användare måste ha rollen Distributionshanteraren för att kunna konfigurera produktionspipelines.

NOTE
Det går inte att konfigurera en produktionspipeline förrän följande har inträffat:
  • Programmet skapas.
  • Git-databasen har minst en gren.
  • Produktions- och mellanlagringsmiljöerna skapas.

Innan du börjar distribuera koden måste du konfigurera dina pipeline-inställningar från Cloud Manager.

NOTE
Du kan redigera pipeline-inställningar efter den första konfigurationen.

Lägg till en ny produktionspipeline adding-production-pipeline

När du har konfigurerat programmet och har minst en miljö med användargränssnittet för Cloud Manager kan du lägga till en produktionspipeline genom att följa de här stegen.

TIP
Innan du konfigurerar en pipeline för framtagning bör du läsa AEM Quick Site Creation Journey för att få en heltäckande guide med det lättanvända verktyget AEM Quick Site Creation. Den här resan kan hjälpa er att effektivisera framtidens utveckling av er AEM-webbplats, så att ni snabbt kan anpassa er webbplats utan kunskaper om AEM bakomliggande system.
  1. Logga in på Cloud Manager på experience.adobe.com.

  2. Klicka på Experience Manager i avsnittet Snabbåtkomst.

  3. Klicka på Cloud Manager på den vänstra panelen.

  4. Välj en organisation som du vill ha.

  5. Klicka på ett program på konsolen Mina program.

  6. Välj programmet på konsolen Mina program.

  7. Navigera till kortet Pipelines på sidan Programöversikt och klicka på Lägg till för att välja Lägg till produktionspipeline.

    Rörledningskortet i programhanteraren - översikt

  8. Dialogrutan Lägg till produktionspipeline visas. Ange ett Pipelinenamn som identifierar din pipeline tillsammans med följande alternativ. Klicka på Fortsätt.

    Utlösare för distribution - Du har följande alternativ när du definierar distributionsutlösare för att starta pipeline.

    • Manuell - Starta pipelinen manuellt.
    • Vid Git-ändringar - Startar CI/CD-flödet när implementeringar läggs till i den konfigurerade Git-grenen. Med det här alternativet kan du fortfarande starta pipelinen manuellt efter behov.

    Beteende vid viktiga måttfel - Under pipeline-konfiguration eller redigering kan Distributionshanteraren definiera pipelinens beteende när ett viktigt fel påträffas i någon av kvalitetsportarna. De tillgängliga alternativen är:

    • Fråga varje gång - Standardinställning. Det kräver manuell åtgärd vid varje viktigt fel.
    • Misslyckades omedelbart - Om du väljer det här alternativet avbryts pipelinen när ett viktigt fel inträffar. Den här processen emulerar i princip en användare som manuellt avvisar varje fel.
    • Fortsätt omedelbart - Om du väljer det här alternativet fortsätter pipelinen automatiskt när ett viktigt fel inträffar. Den här processen emulerar i princip en användare som manuellt godkänner varje fel.

    Konfiguration av produktionspipeline

  9. På fliken Source Code väljer du vilken typ av kod som pipeline ska bearbeta.

Mer information om olika typer av pipelines finns i CI/CD Pipelines.

Stegen för att slutföra skapandet av produktionsflödet varierar beroende på vilken typ av källkod du har valt. Följ länkarna ovan för att gå till nästa avsnitt i det här dokumentet så att du kan slutföra konfigurationen av din pipeline.

Jag använder en fullständig stackkod full-stack-code

En fullständig kodrapport distribuerar samtidigt kodbyggen i bakände och framände som innehåller en eller flera AEM-serverprogram tillsammans med HTTPD/Dispatcher-konfiguration.

NOTE
Om det redan finns en kodrapport med fullständig stapel för den valda miljön inaktiveras den här markeringen.

Så här konfigurerar du en fullständig stackkodspipeline:

  1. Ange följande alternativ på fliken Source-kod.

    • Databas - Definierar från vilken Git-databas som pipeline ska hämta koden.
    note tip
    TIP
    Mer information om hur du lägger till och hanterar databaser i Cloud Manager finns i Lägg till och hantera databaser.
    • Git-grenen - I listrutan väljer du vilken gren i den valda databasen som pipeline ska bygga från. Standardvärdet är main. I pipeline används den valda grenen som källa för bygge och distribution. Om det behövs klickar du på Uppdatera för att uppdatera listan över tillgängliga grenar för den valda databasen. Använd det här alternativet om en nyligen skapad gren inte visas i listan.

    • Skapa strategi

      • Fullständigt bygge - Bygger alla moduler i databasen varje gång

      • BETA Smart Build - Skapar endast moduler som har ändrats sedan den senaste implementeringen.
        Lär dig mer om att använda Smart Build i en icke-produktionsprocess.

        note important
        IMPORTANT
        Smart Build är endast tillgängligt för pipelines för kodkvalitet och distributionspipelines för Dev Full Stack Code.

        * **Ignorera webbnivåkonfiguration** - När det här alternativet är markerat distribueras inte webbnivåkonfigurationen.

    • Pausa innan du distribuerar till produktion - Pausar pipeline innan du distribuerar till produktion.

    • Schemalagd - Gör att användaren kan aktivera den schemalagda produktionsdistributionen.

    Fullständig stackkod

  2. Klicka på Fortsätt om du vill gå vidare till fliken Experience Audit där du kan definiera sökvägarna som alltid ska inkluderas i Experience Audit.

    Lägg till Experience Audit

  3. Ange sökvägar som ska inkluderas i Experience Audit.

  4. Klicka på Spara för att spara din pipeline.

När pipeline körs skickas och utvärderas sökvägar som konfigurerats för Experience Audit baserat på prestanda, tillgänglighet, SEO, bästa praxis och PWA-tester. Mer information finns i Om Experience Audit Results.

Pipelinen sparas och du kan nu hantera dina pipelines på kortet Pipelines på sidan Programöversikt.

Jag använder målinriktad distribution targeted-deployment

En riktad distribution distribuerar kod endast för utvalda delar av AEM-programmet. I en sådan distribution kan du välja att Inkludera ska vara en av följande typer av kod:

  • Konfiguration - Konfigurera inställningar för olika funktioner i din AEM-miljö.

    • Se Använda konfigurationsförlopp för en lista över konfigurationer som stöds, som omfattar vidarebefordran av loggar, rensningsrelaterade underhållsåtgärder och olika CDN-konfigurationer, och för att hantera dem i din databas så att de distribueras korrekt.
    • När du kör en riktad distributionsprocess distribueras konfigurationer, förutsatt att de sparas i den miljö, databas och gren som definieras i pipeline.
    • Det kan bara finnas en konfigurationspipeline per miljö.
  • Konfigurera Edge Delivery Services konfigurationsflöde - Edge Delivery konfigurationsförlopp har inte separata utvecklings-, mellanlagrings- och produktionsmiljöer. I AEM as a Cloud Service går förändringarna igenom utvecklingsnivå, utvecklingsnivå och produktionsnivå. En Edge Delivery Configuration Pipeline tillämpar däremot konfigurationen direkt på alla Edge Delivery Sites-domäner som är registrerade i Cloud Manager. Mer information finns i Lägg till en Edge Delivery-pipeline.

  • Front End Code - Konfigurera JavaScript och CSS för frontdelen av ditt AEM-program.

    • Med rörledningar kan utvecklarna bli mer självständiga och utvecklingsprocessen kan accelereras.
    • I dokumentet Utveckla platser med frontdelspipeline finns information om hur den här processen fungerar tillsammans med vissa överväganden som du bör vara medveten om för att få ut mesta möjliga av processen.
  • Webbnivåkonfiguration - Konfigurera Dispatcher-egenskaper för att lagra, bearbeta och leverera webbsidor till klienten.

    • Mer information finns i dokumentet CI/CD Pipelines.
    • Om det finns en kodrapport på webbnivå för den valda miljön är det här valet inaktiverat.
    • Om du skapar en webbskiktskonfigurationspipeline för en miljö med en befintlig pipeline med en hel hög ignoreras webbskiktskonfigurationen i pipeline med en hel hög. Den här ändringen påverkar bara webbnivåkonfigurationen i den miljön.
NOTE
Rörledningar för webbnivå och konfiguration stöds inte i privata databaser. Mer information och en fullständig lista över begränsningar finns i Lägga till privata databaser i Cloud Manager.

Så här konfigurerar du en riktad distributionspipeline:

  1. Välj vilken distributionstyp du behöver.

Målinriktade distributionsalternativ

  1. Definiera berättigade distributionsmiljöer.

    • Om din pipeline är en distributionsprocess måste du välja till vilka miljöer den ska distribueras.
  2. Ange följande alternativ under Source Code:

    • Databas - Det här alternativet definierar från vilken Git-repo som pipelinen ska hämta koden.
    note tip
    TIP
    Se Lägga till och hantera databaser så att du kan lära dig hur du lägger till och hanterar databaser i Cloud Manager.
    • Git-grenen - Det här alternativet definierar från vilken gren i den valda pipeline som ska hämta koden.
      • Ange de första tecknen i förgreningsnamnet och funktionen Komplettera automatiskt i det här fältet. Här hittas de matchande grenar som du kan välja.
    • Kodplats - Det här alternativet definierar sökvägen i grenen för den valda rapporten från vilken pipelinen ska hämta koden.
    • Pausa innan du distribuerar till produktion - Det här alternativet pausar pipelinen innan den distribueras till produktion.
    • Schemalagd - Gör att användaren kan aktivera den schemalagda produktionsdistributionen. Endast tillgängligt för riktade distributioner på webbnivå.

    Konfigurera pipeline

  3. Klicka på Spara.

Pipelinen sparas och du kan nu hantera dina pipelines på kortet Pipelines på sidan Programöversikt.

BETA: Om att använda Smart Build i en produktionsprocess about-smart-build-production-pipeline

Smart Build i Cloud Manager är en optimerad byggstrategi för produktionspipelines. Smart Build minskar byggtiden genom att cache-lagra moduler och återskapa endast de moduler som har ändrats sedan den senaste körningen. Oförändrade moduler återanvänds från cacheminnet, medan endast ändrade moduler och deras beroenden återskapas, vilket förbättrar effektiviteten för iterativa utvecklingsarbetsflöden.

NOTE
Intresserad av betaversionen? Mejla beta_quickbuild_cmpipelines@adobe.com med ditt Adobe OrgID och program-ID.
IMPORTANT
Den första körningen efter aktiveringen av Smart Build fungerar som en fullständig version eftersom cachen är tom.

Smart Build rekommenderas när du har följande:

  • Du utvecklar och implementerar ofta inkrementella förändringar.
  • Ditt projekt innehåller flera Maven-moduler.
  • Fullversioner tar lång tid.

Smart Build är inte alltid idealiskt när du har följande:

  • Din version är starkt beroende av plugin-program som utför åtgärder utanför Maven beroendediagram.
  • Du måste verifiera alla versioner av varje körning.

Förstå byggprestanda smart-build-performance

Den prestandaökning som kan uppnås med Smart Build beror på flera faktorer, bland annat följande:

  • Antalet moduler i projektet.
  • Kodändringarnas frekvens och omfattning.
  • Distributionen av beroenden mellan moduler.

I allmänhet kan projekt med många oberoende moduler se den största förbättringen.

Cacheavanmälan per modul smart-build-cache-optout

Smart Build har finkornig kontroll som gör att du kan inaktivera cachelagring för specifika moduler. Den här funktionen är användbar när vissa moduler:

  • Använd plugin-program som exec-maven-plugin eller maven-antrun-plugin.
  • Utför filåtgärder som inte spåras av Maven-beroenden.
  • Cachelagrat innehåll ger inkonsekventa resultat.

Inaktivera cachelagring för en modul smart-build-disable-caching

Du kan lägga till följande egenskap i den berörda modulens pom.xml:

<properties>
  <maven.build.cache.enabled>false</maven.build.cache.enabled>
</properties>

Den här syntaxen tvingar modulen att återskapa varje pipeline-körning medan andra moduler fortfarande har nytta av cachelagring.

Begränsningar och överväganden när Smart Build används smart-build-limitations

Tänk på följande när du använder Smart Build:

  • Smart Build bygger på Maven-beroendeanalys.
  • Ändringar utanför beroendediagrammet kan inte utlösa rekonstruktioner.
  • Vissa plugin-program kanske inte är helt kompatibla med cachning.
  • Du kan när som helst växla tillbaka till Fullständigt bygge genom att redigera produktionsflödet.

Om du stöter på oväntat byggbeteende bör du inaktivera cachelagring för specifika moduler eller tillfälligt byta din byggstrategi till Fullständigt bygge.

Felsöka problem med Smart Build smart-build-troubleshoot

Problem
Föreslagna lösningar
Byggresultaten är inkonsekventa
・ Inaktivera cachelagring för berörda moduler.
・ Verifiera plugin-programmets beteende (särskilt exec/antrun plugin-program).
Ingen prestandaförbättring
・ Kontrollera att flera körningar har utförts (cacheupphettning).
・ Kontrollera om de flesta moduler ändras ofta.
Oväntade artefakter eller saknade ändringar
・ Kontrollera om ändringarna ligger utanför Maven-beroendespårning.
・ Använd Fullständigt bygge för verifiering.

Se Lägga till en produktionspipeline för att aktivera Smart Build.

Hoppa över Dispatcher-paket skip-dispatcher-packages

Om du vill skapa Dispatcher-paket i pipeline utan att publicera dem för att bygga lagring kan du inaktivera publiceringsalternativet. Om du gör det kan det hjälpa till att minska körtiden.

Följande konfiguration för att inaktivera publicering av Dispatcher-paket måste läggas till via projektfilen pom.xml. En miljövariabel fungerar som en flagga som du anger i Cloud Manager byggbehållare för att avgöra när Dispatcher-paket ska ignoreras.

<profile>
  <id>only-include-dispatcher-when-it-isnt-ignored</id>
  <activation>
    <property>
      <name>env.IGNORE_DISPATCHER_PACKAGES</name>
      <value>[!NOTE]rue</value>
    </property>
  </activation>
  <modules>
    <module>dispatcher</module>
  </modules>
</profile>
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab