Codeimplementatie code-deployment

Leer hoe u uw code implementeert en wat er gebeurt in Cloud Manager wanneer u dat doet.

Code implementeren met Cloud Manager deploying-code-with-cloud-manager

Zodra u uw productiepijplijn met inbegrip van de noodzakelijke bewaarplaats en milieu's hebt gevormd, bent u bereid om uw code op te stellen.

  1. Klik opstellen van Cloud Manager om het plaatsingsproces te beginnen.

    Deploy knoop

  2. De het schermvertoningen van de Uitvoering van de Pijpleiding. Klik bouwen om het proces te beginnen.

    bouwt knoop

Het bouwstijlproces begint het proces van de codeplaatsing met inbegrip van de volgende stappen:

  • Werkgebiedimplementatie
  • Werkgebied testen
  • Implementatie van productie

U kunt de stappen van diverse plaatsingsprocessen herzien door logboeken, of het herzien van resultaten, voor de testende criteria te bekijken.

Implementatiestappen deployment-steps

Een aantal acties komt tijdens elke stap van de plaatsing voor, die in deze sectie worden beschreven. Zie de details van het proces van de sectie Plaatsingvoor technische details van hoe de code zelf achter-de-scènes wordt opgesteld.

Implementatiestap werkgebied stage-deployment

De plaatsing van het Stadium stap omvat de volgende acties:

  • Bevestiging: Deze stap zorgt ervoor dat de pijpleiding wordt gevormd om de momenteel beschikbare middelen te gebruiken, bijvoorbeeld dat de gevormde tak bestaat en dat de milieu's beschikbaar zijn.
  • Bouwstijl & het Testen van de Eenheid: Deze stap stelt een inperkt bouwstijlproces in werking. Zie het document het Milieu van de Bouwstijlvoor details.
  • Scannen van de Code: Deze stap evalueert de kwaliteit van uw toepassingscode. Zie het document Begrijpend de Resultaten van de Testvoor details op het het testen proces.
  • opstellen aan Stadium

plaatsing van het Stadium

Teststap werkgebied stage-testing

De het testen van het Stadium stap omvat de volgende acties:

Implementatiestap voor productie production-deployment

De stap van de Plaatsing van de Productie, omvat de volgende acties:

  • Toepassing voor Goedkeuring

    • Deze optie wordt toegelaten terwijl het vormen van de pijpleiding.
    • Gebruikend deze optie, kunt u of uw productieplaatsing plannen of nu klikken om de productieleiding onmiddellijk uit te voeren.
  • Plaatsing van de Productie van het Programma

    • Deze optie wordt toegelaten terwijl het vormen van de pijpleiding.

    • De geplande datum en tijd worden gespecificeerd in termen van de tijdzone van de gebruiker.

      plaatsing van het Programma

  • CSE Steun (als toegelaten)

  • opstellen aan Productie

plaatsing van de Productie

Zodra uw plaatsing volledig is, is uw code in zijn gerichte milieu en u kunt de logboeken bekijken.

Volledige Plaatsing van de Plaatsing

Tijdstippen timeouts

Er wordt een time-out toegepast in de volgende stappen als er op feedback van gebruikers wordt gewacht:

Stap
Time-out
Testen van de codekwaliteit
7 dagen
Beveiligingstests
7 dagen
Prestatietesten
7 dagen
Goedkeuringsaanvraag (fase)
7 dagen
Goedkeuringsaanvraag (productie)
14 dagen
Implementatie van planningsproductie
14 dagen
Implementatie van beheerde productie
14 dagen

Implementatieproces — details deployment-process

Cloud Manager uploadt alle doelbestanden/*.zip die tijdens het productieproces worden geproduceerd naar een opslaglocatie. Deze artefacten worden teruggewonnen van deze plaats tijdens opstellen fasen van de pijpleiding.

Wanneer Cloud Manager aan niet productietopologieën opstelt, is het doel de plaatsing zo snel mogelijk te voltooien en daarom worden de artefacten aan alle knopen gelijktijdig opgesteld als volgt:

  1. Cloud Manager bepaalt of elk artefact een AEM- of verzendingspakket is.

  2. Cloud Manager verwijdert alle verzenders van het taakverdelingsmechanisme om de omgeving tijdens de implementatie te isoleren.

    • Tenzij anders geconfigureerd, kunt u wijzigingen in het taakverdelingsmechanisme in ontwikkelings- en staging-implementaties overslaan, d.w.z. voor ontwikkelomgeving, stappen loskoppelen en koppelen in zowel niet-productiepijpleidingen als voor de staging-omgeving in de productiepijplijn.

    overslaan taakverdelingsmechanisme

    note note
    NOTE
    Deze functie wordt naar verwachting vooral gebruikt door 1-1-1 klanten.
  3. Elk AEM artefact wordt opgesteld aan elke AEM instantie via de Manager APIs van het Pakket, met pakketgebiedsdelen die de plaatsingsorde bepalen.

    • Meer over leren hoe u pakketten kunt gebruiken om nieuwe functionaliteit te installeren, inhoud tussen instanties over te brengen, en file de inhoud van de bewaarplaats, gelieve te verwijzen naar de document Manager van het Pakket.
    note note
    NOTE
    Alle AEM artefacten worden opgesteld aan zowel de auteur als de uitgevers. De wijzen van de looppas zouden moeten worden leveraged wanneer de knoop-specifieke configuraties worden vereist. Om meer over te leren hoe runtime-wijzen u toestaan om uw AEM instantie voor een specifiek doel te stemmen, gelieve te verwijzen naar de sectie van de Wijzen van de Looppas van het document die aan AEM as a Cloud Service opstellen.
  4. Het artefact van de verzender wordt als volgt op elke verzender geïmplementeerd:

    1. Van de huidige configuraties wordt een back-up gemaakt en naar een tijdelijke locatie gekopieerd.
    2. Alle configuraties worden verwijderd, behalve de onveranderlijke bestanden. Verwijs naar het document de Configuraties van Dispatchervoor meer details. Hierdoor worden de mappen gewist zodat er geen zwevende bestanden achterblijven.
    3. Het artefact wordt geëxtraheerd naar de map httpd . Onveranderbare bestanden worden niet overschreven. Wijzigingen die u aanbrengt in onveranderlijke bestanden in uw it-opslagplaats, worden genegeerd op het moment van implementatie. Deze bestanden vormen de kern van het AMS-verzenderframework en kunnen niet worden gewijzigd.
    4. Apache voert een configuratietest uit. Als er geen fouten worden gevonden, wordt de service opnieuw geladen. Als er een fout optreedt, worden de configuraties hersteld vanaf de back-up, wordt de service opnieuw geladen en wordt de fout geretourneerd naar Cloud Manager.
    5. Elk pad dat in de pijplijnconfiguratie is opgegeven, wordt ongeldig gemaakt of verwijderd uit het cachegeheugen van de verzender.
    note note
    NOTE
    Cloud Manager verwacht dat het verzendingsartefact de volledige bestandsset bevat. Alle Dispatcher-configuratiebestanden moeten aanwezig zijn in de it-opslagplaats. Ontbrekende bestanden of mappen leiden tot een implementatiefout.
  5. Nadat alle AEM- en verzendingspakketten naar alle knooppunten zijn geïmplementeerd, worden de verzenders weer toegevoegd aan het taakverdelingsmechanisme en is de implementatie voltooid.

    note note
    NOTE
    U kunt veranderingen in het taakverdelingsmechanisme in ontwikkeling en het opvoeren van Plaatsingen, d.w.z. voor ontwikkelomgeving overslaan, stappen in zowel niet productiepijpleidingen losmaken en vastmaken, als voor het opvoeren van milieu de productiepijpleiding.

Implementatie naar productiefase deployment-production-phase

Het proces voor het opstellen aan productietopologieën verschilt lichtjes om effect aan AEM plaatsbezoekers te minimaliseren.

Productieimplementaties volgen doorgaans dezelfde stappen als hierboven, maar op een voortschrijdende manier:

  1. Implementeer AEM pakketten naar de auteur.
  2. Dispatcher1 loskoppelen van het taakverdelingsmechanisme.
  3. Implementeer AEM pakketten om te publiceren1 en het verzendingspakket om dispatcher1 parallel in de cache van de uitlijningsdispatcher te plaatsen.
  4. Plaats dispatcher1 terug in het taakverdelingsmechanisme.
  5. Als dispatcher1 weer in bedrijf is, koppelt u dispatcher2 af van het taakverdelingsmechanisme.
  6. Implementeer AEM pakketten om te publiceren2 en het verzendingspakket naar dispatcher2 in parallel, uitlijningscachegeheugen.
  7. Plaats dispatcher2 terug in het taakverdelingsmechanisme.

Dit proces gaat verder tot de plaatsing alle uitgevers en verzenders in de topologie heeft bereikt.

Uitvoermodus noodleiding emergency-pipeline

In kritieke situaties moeten klanten van Adobe Managed Services mogelijk codeveranderingen in hun stadium en productiemilieu's opstellen zonder het wachten op een volledige de testcyclus van Cloud Manager uit te voeren.

Om deze situaties het hoofd te bieden, kan de Cloud Manager-productiepijplijn in noodsituaties worden uitgevoerd. Als deze modus wordt gebruikt, worden de stappen voor de beveiligings- en prestatietest niet uitgevoerd. Alle andere stappen, met inbegrip van om het even welke gevormde goedkeuringsstappen, worden uitgevoerd zoals op de normale wijze van de pijpleidingsuitvoering.

NOTE
De functie voor de uitvoering van de noodpijpleiding wordt per programma geactiveerd door de succestechnici van de Klant.

Uitvoermodus voor noodpijpleiding gebruiken using-emergency-pipeline

Wanneer het beginnen van een uitvoering van de productiepijplijn, als de eigenschap van de spoedpijpleiding uitvoeringswijze voor het programma is geactiveerd, kunt u de uitvoering op of normale of noodwijze van een dialoogdoos beginnen.

de pijpleidingsopties van de Looppas

Wanneer het bekijken van de pagina van de details van de pijpleidingsuitvoering voor een uitvoering die op noodwijze wordt in werking gesteld, tonen de broodkruimels bij de bovenkant van het scherm een indicator dat de pijpleiding op noodwijze uitvoert.

de wijzebroodkruimels van de Noodsituatie

Het uitvoeren van een pijplijn in noodmodus kan ook via de Cloud Manager API of CLI worden uitgevoerd. Als u een uitvoering wilt starten in de noodmodus, dient u een PUT -verzoek in bij het eindpunt van de uitvoering van de pijpleiding met de queryparameter ?pipelineExecutionMode=EMERGENCY of, wanneer u de CLI gebruikt:

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

Het opnieuw uitvoeren van een Plaatsing van de Productie reexecute-deployment

In zeldzame gevallen kunnen de stappen van de productielocatie om voorbijgaande redenen ontbreken. In dergelijke gevallen wordt heruitvoering van de productieleidingsstap ondersteund zolang de productieleidingsstap is voltooid, ongeacht het type voltooiing (bv. succesvol, geannuleerd of niet succesvol). De heruitvoering leidt tot een nieuwe uitvoering gebruikend de zelfde pijpleiding die uit drie stappen bestaat.

  1. bevestigt stap - dit is hoofdzakelijk de zelfde bevestiging die tijdens een normale pijpleidingsuitvoering voorkomt.
  2. bouwstijlstap - in de context van een heruitvoering, kopieert de bouwstijlstap artefacten en voert niet eigenlijk een nieuw bouwstijlproces uit.
  3. de stap van de productieplaatsing - dit gebruikt de zelfde configuratie en de opties zoals de stap van de productieplaatsing in een normale pijpleidingsuitvoering.

In dergelijke omstandigheden waar een heruitvoering mogelijk is, verstrekt de pagina van de de statuspagina van de productiepijpleiding re-execute optie naast de gebruikelijke Download bouwt logboek optie.

re-execute optie in het venster van het pijpleidingsoverzicht

NOTE
In een heruitvoering, wordt de bouwstijlstap geëtiketteerd in UI om erop te wijzen dat het artefacten kopieert, niet re-bouwt.

Beperkingen limitations

  • Het opnieuw uitvoeren van de stap van de productieplaatsing is slechts beschikbaar voor de laatste uitvoering.
  • Heruitvoering is niet beschikbaar voor terugdraaiacties of het uitvoeren van push-updates.
  • Als de laatste uitvoering is mislukt op een willekeurig punt vóór de stap voor de implementatie van de productie, is het niet mogelijk de productie opnieuw uit te voeren.

API opnieuw uitvoeren reexecute-api

Naast het zijn beschikbaar in UI, kunt u Cloud Manager APIgebruiken om wederuitvoeringen teweeg te brengen evenals uitvoeringen te identificeren die als re-uitvoeringen werden teweeggebracht.

Een nieuwe uitvoering activeren triggering

Om een heruitvoering teweeg te brengen, moet een PUT verzoek aan de Verbinding van de HAL http://ns.adobe.com/adobecloud/rel/pipeline/reExecute op de productie worden gemaakt stapstaat.

  • Als deze koppeling aanwezig is, kan de uitvoering vanaf die stap opnieuw worden gestart.
  • Als dit niet het geval is, kan de uitvoering niet vanaf die stap opnieuw worden gestart.

Deze verbinding is slechts ooit beschikbaar voor de productie stelt stap op.

 {
  "_links": {
    "http://ns.adobe.com/adobecloud/rel/pipeline/logs": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/logs",
      "templated": false
    },
    "http://ns.adobe.com/adobecloud/rel/pipeline/reExecute": {
      "href": "/api/program/4/pipeline/1/execution?stepId=2983530",
      "templated": false
    },
    "http://ns.adobe.com/adobecloud/rel/pipeline/metrics": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/metrics",
      "templated": false
    },
    "self": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530",
      "templated": false
    }
  },
  "id": "6187842",
  "stepId": "2983530",
  "phaseId": "1575676",
  "action": "deploy",
  "environment": "weretail-global-b75-prod",
  "environmentType": "prod",
  "environmentId": "59254",
  "startedAt": "2022-01-20T14:47:41.247+0000",
  "finishedAt": "2022-01-20T15:06:19.885+0000",
  "updatedAt": "2022-01-20T15:06:20.803+0000",
  "details": {
  },
  "status": "FINISHED"

De syntaxis van de waarde href van de HAL-koppeling is slechts een voorbeeld en de werkelijke waarde moet altijd worden gelezen van de HAL-koppeling en niet worden gegenereerd.

Als u een PUT -aanvraag naar dit eindpunt verzendt, resulteert dit in een 201 -reactie als dit gelukt is. De nieuwe uitvoering wordt dan vertegenwoordigd door de hoofdtekst van de reactie. Dit is vergelijkbaar met het starten van een normale uitvoering via de API.

Een nieuwe uitvoering identificeren identifying

Herhaalde uitvoeringen kunnen worden geïdentificeerd door de waarde RE_EXECUTE in het veld trigger .

recommendation-more-help
c6cdc82b-cee9-48e0-a6ee-48149d5e72c3