Lägg till en icke-produktionspipeline configuring-non-production-pipelines
Lär dig hur du använder Cloud Manager för att skapa och konfigurera rörledningar för icke-produktion för att distribuera koden. Om du först vill ha en mer konceptuell översikt över hur rörledningar fungerar i Cloud Manager kan du läsa CI/CD-pipelines.
Översikt overview
Med pipelines i Cloud Manager kan Distributionshanteraren skapa två olika typer av pipelines.
- Produktionspipeliner - En produktionspipeline är en konstruerad pipeline som består av en serie samordnade steg för att ta källkod hela vägen in i produktionen.
- Icke-produktionsförlopp - En icke-produktionsförlopp används främst för att köra kodkvalitetsgenomsökningar eller för att distribuera källkod till en utvecklingsmiljö.
Detta dokument fokuserar på icke-produktionsrörledningar. Mer information om hur du konfigurerar produktionspipelines finns i dokumentet Konfigurera produktionspipelines.
Det finns två typer av icke-produktionsrörledningar:
- Kodkvalitetsförgreningar - Dessa kör kodkvalitet genom att skanna koden i en Git-gren och kör stegen för bygg- och kodkvalitet.
- Distributionspipeliner - Förutom att utföra steg för bygg- och kodkvalitet, som till exempel pipelines för kodkvalitet, distribuerar dessa pipelines även koden till en icke-produktionsmiljö.
Lägg till en ny icke-produktionspipeline add-non-production-pipeline
När du har konfigurerat ett program och minst en miljö i användargränssnittet i Cloud Manager kan du lägga till rörledningar som inte är avsedda för produktion. Använd de här rörledningarna för att testa kodkvaliteten innan du distribuerar till produktionsmiljöer.
-
Logga in på Cloud Manager på my.cloudmanager.adobe.com och välj rätt organisation och program.
-
Öppna förloppskortet i Cloud Manager och klicka på Lägg till och välj sedan Lägg till icke-produktionsförlopp.
-
På fliken Konfiguration i dialogrutan Lägg till icke-produktionspipeline väljer du den typ av pipeline som du vill skapa, något av följande:
- Kodkvalitetspipeline - Skapar en pipeline som bygger koden, kör enhetstester och utvärderar kodkvaliteten utan att distribuera den till någon miljö.
- Distributionspipeline - Skapar en pipeline som bygger koden, kör enhetstester, utvärderar kodkvaliteten och distribuerar till en miljö.
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
|---|---|---|
| Avsnitt | Alternativ | Beskrivning |
| Pipelinekonfiguration | Pipelinenamn som inte är i produktion | Ange en beskrivning av din pipeline i fältet Namn på icke-produktionsförlopp. |
| Testar |
Synlig endast när du redigerar en icke-produktionspipeline.
|
|
| Distributionsalternativ | Utlösare för distribution |
|
| Beteende vid viktiga måttfel |
|
|
| Kryssrutan Godkänn efter scendistribution | Synlig endast när du redigerar en icke-produktionspipeline. Välj det här alternativet om du vill kräva godkännande efter distributionen till scenmiljön innan pipeline kan fortsätta. Om det här alternativet inte är markerat fortsätter pipelinen baserat på det konfigurerade beteendet. |
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 | ||
|---|---|---|
| Avsnitt | Alternativ | Beskrivning |
| Pipelinekonfiguration | Pipelinenamn som inte är i produktion | Ange en beskrivning av din pipeline i fältet Namn på icke-produktionsförlopp. |
| Kvalificerad distributionsmiljö | Om din pipeline är en distributionsprocess måste du välja vilka miljöer Cloud Manager distribuerar koden i. | |
| Testar |
Synlig endast när du redigerar en icke-produktionspipeline.
|
|
| Distributionsalternativ | Utlösare för distribution |
|
| Beteende vid viktiga måttfel |
|
|
| Kryssrutan Godkänn efter scendistribution | Synlig endast när du redigerar en icke-produktionspipeline. Välj det här alternativet om du vill kräva godkännande efter distributionen till scenmiljön innan pipeline kan fortsätta. Om det här alternativet inte är markerat fortsätter pipelinen baserat på det konfigurerade beteendet. |
|
| Kryssrutan Hoppa över ändringar av belastningsutjämnare | Välj det här alternativet om du inte vill att pipeline ska kunna göra belastningsutjämningsändringar under distributionen. | |
| Dispatcher-konfiguration |
Rollen Distributionshanteraren kan konfigurera en uppsättning innehållssökvägar som antingen är ogiltiga eller tömda från AEM Dispatcher-cachen när en pipeline körs. Cloud Manager kör dessa cacheåtgärder som en del av distributionssteget, precis efter att innehållspaket har distribuerats. De här inställningarna använder AEM Dispatcher standardbeteende. Så här konfigurerar du
|
|
| Rörledning | Kryssrutan Experience Audit | Välj det här alternativet om du vill inkludera ett Experience Audit-steg i pipeline. När det här alternativet är aktiverat innehåller pipeline steget Experience Audit efter fliken Source Code. |
- Klicka på Fortsätt i det nedre högra hörnet av dialogrutan Lägg till icke-produktionsförlopp .
- Välj den typ av kod som pipeline är konfigurerad för att bygga och distribuera.
Distribuerar hela AEM-programmet, inklusive programkod och som standard webbnivåkonfiguration.
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
|---|---|---|
| Avsnitt | Alternativ | Beskrivning |
| Source-kod | Databas | I listrutan väljer du Git-databasen som pipelinen använder som källa. Cloud Manager skapar kod från den databas du väljer här. |
| 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 |
|
|
| Kryssrutan Ignorera webbnivåkonfiguration | Välj det här alternativet om du vill hoppa över distributionen av webbnivåkonfigurationen i en fullständig stackkodspipeline. Låt alternativet vara avmarkerat för att distribuera webbnivåkonfigurationen tillsammans med pipeline-koden. | |
| Rörledning | Kryssrutan Experience Audit | Välj det här alternativet om du vill inkludera ett Experience Audit-steg i pipeline. När det här alternativet är aktiverat innehåller pipeline steget Experience Audit efter fliken Source Code. |
Distribuerar endast webbnivåkonfiguration, t.ex. Dispatcher-egenskaper som används för att lagra, bearbeta och leverera webbsidor till klienten. När du väljer Webbnivåkonfiguration skapar Cloud Manager en pipeline som är dedikerad till distribution av webbnivåkonfiguration.
Om det redan finns en fullständig stackpipeline visar Cloud Manager ett meddelande om att den befintliga fullständiga stackpipelinen ignoreras i konfigurationen av webbnivån när en konfigurationspipeline för webbskikt skapas. När du har skapat konfigurationsflödet för webbnivån hanterar Cloud Manager distributioner av webbnivåkonfigurationer via den pipeline som ingår i stacken i stället för via den fullständiga stackpipeline.
| table 0-row-3 1-row-3 2-row-3 3-row-3 | ||
|---|---|---|
| Avsnitt | Alternativ | Beskrivning |
| Source-kod | Databas | I listrutan väljer du den Git-databas som innehåller webbnivåkonfigurationen. |
| Git-grenen | Välj den gren i den valda databasen som Cloud Manager använder för distributionen. 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. | |
| Kodplats | Ange sökvägen i den valda databasen som innehåller den webbskiktskonfiguration som ska distribueras. Standardplatsen är databasroten (/). |
- Klicka på Spara.
Om att använda Smart Build i en icke-produktionsprocess about-smart-build
Smart Build i Cloud Manager är en optimerad byggstrategi för icke-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.
Smart Build är för närvarande endast tillgängligt för följande:
- Kodkvalitetsledningar.
- Utveckla rörledningar för driftsättning i högklasser.
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-pluginellermaven-antrun-plugin. - Utför filåtgärder som inte spåras av Maven-beroenden.
- Producera inkonsekventa resultat vid cachelagring.
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 icke-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
・ verifiera plugin-programmets beteende (särskilt
exec/antrun plugin-program).・ Kontrollera om de flesta moduler ändras ofta.
・ Använd Fullständigt bygge för verifiering.
Se Lägg till en icke-produktionsprocess om du vill aktivera Smart Build.
Nästa steg the-next-steps
När du har konfigurerat pipeline kan du distribuera koden. Mer information finns i Koddistribution.
Videosjälvstudie video-tutorial
Den här videon ger en översikt över processen att skapa pipeline, som beskrivs i det här dokumentet.