Spoke-Deployment¶
Operator-Runbook für das Deployment einer genehmigten und gemergten spoke-Änderung: ein neuer spoke oder die Änderung eines bestehenden. Lies es zusammen mit Neuer Spoke und Pipelines und Workflows.
1. Bevor du anfängst¶
- Der pull request ist nach
maingemergt. - Du kennst den genauen Pfad jeder spoke-Datei im pull request, relativ zum Ordner
spokes/der Plattform- Umgebung, zum Beispielteam-a/canvas_app1_dev.json. - Du hast Zugriff auf die pipelines der richtigen Plattform-Umgebung.
2. Den spoke planen¶
- Öffne die pipelines und wähle die spoke-pipeline (
spoke). - Stelle sicher, dass der Lauf den Branch
mainverwendet. - Setze die spoke-Auswahl (
spokeGlob) auf die Datei, die du deployen willst. Verwende den Pfad relativ zuspokes/, zum Beispielteam-a/canvas_app1_dev.json. Verwende nicht das Default-Muster, das jeden spoke trifft, es sei denn, du willst alle planen. - Prüfe, dass sich die Entry-pipeline nicht in einem Modus befindet, der nur plant (
whatIf: true), wenn du den spoke anwenden willst (Parameter, die du ändern wirst). - Starte den Lauf.
- Wenn der Lauf zur Genehmigung anhält, prüfe, dass die Stage prepare and plan grün ist. Lies dann die Ausgabe des Terraform-
plans und vergleiche sie mit dem pull request:
- Der plan entspricht den Änderungen im pull request.
- Ersetzungen von Rollenzuweisungen sind üblich und normalerweise kein Problem.
- Wenn der plan Änderungen oder Löschungen für eine neu angelegte spoke-Datei zeigt, stoppe den Lauf und frage einen zweiten Engineer.
- Wenn der pull request mehrere spoke-Dateien enthält, wiederhole den Lauf für jede Datei.
3. Genehmigen und anwenden¶
Bitte einen zweiten Engineer, den plan zu genehmigen (oder genehmige ihn selbst, wo dein Prozess es erlaubt), und verfolge den Lauf, bis er abgeschlossen ist.
4. Das Apply prüfen¶
Wenn die Stage apply grün ist:
- Öffne das apply-Log.
- Prüfe, dass die angeforderte Änderung durchgeführt wurde: Die spoke-Ressourcen sind so erstellt oder geändert, wie der plan es sagte.
- Verlasse dich nicht allein auf die grüne Stage. Wenn die Änderung nicht in der Ausgabe steht, gilt das Deployment nicht als erfolgreich: untersuche es und frage bei Bedarf einen zweiten Engineer.
- Führe die Prüfungen aus Neuer Spoke → Prüfen durch: management group, Tags, Virtual Network, die Verbindung zum hub, die Entra-ID-Gruppen und der Zugriff des Teams.
5. Das Ticket schließen¶
Ergänze im Ticket eine Zeile, dass der spoke deployt ist, weise es dem Anfragenden zu und setze es auf Resolved (Der Standardänderungsprozess).