Umfeld & Förderung
Die Plattform ermöglicht den Transfer von Agenten und Workflows zwischen verschiedenen Phasen (Entwicklung, Staging, Produktion) und zwischen Plattforminstanzen (z. B. von Tietai Cloud in ein Krankenhaus). Die Nutzung ist Tiet · Hub → Platform → Environments die REST-API möglich. Lesen Sie zuerst den nächsten Abschnitt, da drei verschiedene Aspekte des Produkts die Begriffe „Umgebung“ oder „Bereitstellung“ enthalten.
Die untenstehende Navigation entspricht Frontend feat/849-light-rebrand bei 3a99cf9. Die Seite „Umgebungen“ befindet sich unter Tiet · Hub → Platform; ihre Route bleibt /studio/environments.
Was Sie heute verwenden können
| Wo | Was es tut |
|---|---|
| Tiet · Studio → Workflows → Builder → Deploy Menü | Setzt den Status einer Pipeline für die ausgewählte Umgebung auf deployed:<environment slug> und exportiert JSON oder YAML. Es werden keine Hashwerte geprüft, keine Genehmigung angefordert und keine Empfangsbestätigung protokolliert. |
| Admin Console → Platform → Environments | Verwaltet Organisationsumgebungen im Authentifizierungsdienst: Name, Beschreibung, Symbol, Region, Clustername, Standardflag und Variablen. Es verfügt über keine Routen, Richtlinien, Genehmigungen oder Freigaben. |
Tiet · Hub → Platform → Environments (/studio/environments) | Die Seite für die hier beschriebenen Umgebungen: Umgebungen mit Richtlinien, Routen, Manifesten, vertrauenswürdigen Quellen, Genehmigungen und Protokollaufbewahrung. Siehe unten. |
| Die auf dieser Seite beschriebene REST-API | Das gleiche System gilt für Skripte: Umgebungen, Routen, Manifeste, signierte Freigaben, Promotion, Genehmigungen und Quittungen. |
Die mitgelieferte Befehlszeile hydra enthält keine Befehle export, diff, apply, deploy, env oder approvals Verwenden Sie die Webseite oder die API.
Die Seite „Umgebungen“
Jeder mit Berechtigung access:hydra kann die Seite lesen. Änderungen erfordern Superuser-Rechte oder die Berechtigung Manage Environments (manage:hydra.environment); andernfalls wird die Seite mit der Meldung You can view environments. Changing them needs the Manage Environments permission. angezeigt. Die Seite verfügt über einen Selektor Run in (siehe Tiet · Studio Builder) und für Manager über die Schaltflächen Register remote instance und New environment Ihre Registerkarten:
| Tab | Was es enthält |
|---|---|
| Environments (n) | Eine Tabelle mit Environment, Slug, Rank, Status (Abzeichen Default, Protected, Entry, Remote, Archived) und für Manager: Actions: Auf- oder Abstieg, Deploy to Umgebung, What runs in sie, Variables of sie (lokale Umgebungen), Test connection und Reconnect (Remote-Umgebungen), Edit, Archive Die Standardumgebung kann nicht archiviert werden. Show archived (n) listet archivierte Umgebungen auf. |
| Routes (n) | Der Promotion graph und Routes Editor: Route from, Route to, Save routes. No routes: every environment is an entry environment. Der Server lehnt Zyklen, Selbstrouten und Routen zu unbekannten oder archivierten Umgebungen ab. |
| Agents & workflows | Import agents and workflows aus Manifest-YAML-Dateien (mit I reviewed the permission findings und Create drafts), und eine Liste von Agenten und Workflows mit einem Download pro Manifest. |
| Trusted sources | Quellinstanzen, die versucht haben, hier zu deployen, mit Key fingerprint, Trust und Revoke. |
| Approvals | Freigaben, die auf Genehmigung warten, mit Approve und Reject. |
| Retention | Aufbewahrungsdauer der Nutzdaten pro Bereich in Tagen. Die Berechtigung „Compliance verwalten“ ist erforderlich, um dies zu ändern. |
Der Dialog New environment und Edit enthält die Abschnitte Name, Slug, Description, Colour, Rank (nur Anzeigereihenfolge; Routen bestimmen die Weiterleitung) und Policy: Protected, Allow direct deploy, Allow draft execution, Default environment, Promotion into this environment (Approvers required, Four-eyes (requester cannot approve), Approver permission, Require a change reference, Approval expires after (hours), Required compliance gate), Rollback (Vieraugen) und Reason for the change. Abschnitt Register a remote instance fragt nach API URL, Name here, Slug here, Environment on the target und Token issued by the target und speichert anschließend den vom Zielsystem übermittelten Schlüssel-Fingerabdruck. Der Bereitstellungsdialog für eine Remote-Umgebung fragt nach Promote from (Choose the environment the versions come from), Reason und Change reference. Ich habe diese Bildschirme im Quellcode gelesen, aber nicht ausgeführt.
Das Builder-Bereitstellungsmenü
Über die Schaltfläche Deploy in der Builder-Symbolleiste wird ein Menü mit der Überschrift „Pipeline- Version · Umgebung des aktiven Projekts “ geöffnet.
| Artikel | Zustand |
|---|---|
*Deploy version to environment * (eine pro anderer aktiver Umgebung; No other environments. falls keine vorhanden) | Aktiv. Speichert die Pipeline und setzt anschließend ihren Status auf deployed:<slug>. |
| Export as JSON, Export as YAML | Aktiv |
| Enable schedule, Enable trigger, Push to external platform instance, Deployment history | Angezeigt, aber deaktiviert |
Eine im Builder gespeicherte Pipeline ist keine versionierte Version. Sie wird nur in Umgebungen ausgeführt, deren Richtlinien die Ausführung von Entwürfen zulassen. Die unten beschriebene versionierte und hashgeprüfte Freigabe gilt für veröffentlichte Workflow-Versionen und Agenten.
Konzepte
| Begriff | Bedeutung |
|---|---|
| Environment | Eine benannte Phase Ihrer Organisation. Lokal ist eine Phase auf dieser Instanz; remote ist eine andere Plattforminstanz, auf der Sie per Push bereitstellen. |
| Default environment | Wo ein Lauf ausgeführt wird, wenn kein Wert angegeben ist. |
| Route | Ein zulässiger Promotionspfad, zum Beispiel development → staging. Eine Umgebung mit Routen, die in sie hineinführen, ist nur durch Promotion erreichbar. |
| Policy | protected, allow_direct_deploy, allow_draft_execution und die Aktionsregeln: min_approvers, four_eyes, approver_permission, require_change_reference, approval_ttl_hours. |
| Manifest | Ein portables YAML- oder JSON-Dokument für eine Agenten- oder Workflow-Version. Es verweist auf andere Elemente mit der Ziffer slug@version und enthält keine Anmeldeinformationen. Die Versionsnummer wird durch den SHA-256-Hash identifiziert. |
| Release | Ein signierter Satz von Manifesten, der an eine Umgebung gesendet wird, mit Angabe des Auftraggebers, des Grundes und der Änderungsreferenz. Jede Freigabe wird signiert, selbst innerhalb einer einzelnen Instanz. |
| Receipt | Die vom Zielunternehmen unterzeichnete Bestätigung dessen, was es beantragt hat. |
Zwei Regeln erklären den Großteil des Verhaltens:
- Eine Umgebung, deren Richtlinie die Ausführung von Entwürfen zulässt, führt genau das aus, was Sie anfordern. Jede andere Umgebung führt exakt die Version aus, die dort bereitgestellt wurde.
- Eine Version wird nur dann aus einer Umgebung hochgestuft, in der sie ausgeführt wird und die denselben Hashwert aufweist.
Standardumgebungen
Eine Organisation ohne Umgebungen erhält diese bei der ersten Verwendung (pkg/deployenv/defaults.yaml). Alles kann anschließend bearbeitet werden.
| Umfeld | Standard | Geschützt | Direkte Bereitstellung | Entwurfsausführung | Für den Zutritt ist eine Genehmigung erforderlich. |
|---|---|---|---|---|---|
development | Ja | NEIN | Ja | Ja | keiner |
staging | NEIN | NEIN | NEIN | 1 (Direktbereitstellung ist deaktiviert) | |
production | Ja | NEIN | NEIN | 1, Brillenträger, Referenzänderung erforderlich |
Routen: development → staging → production.
Exportiere ein Manifest und führe einen Probelauf durch.
Alle Pfade sind relativ zum API-Root der Instanz, /api auf hydra-server. Authentifizieren Sie sich mit einem Anmeldetoken oder einem API-Token, das den angezeigten Gültigkeitsbereich umfasst.
# list exportable workflows (needs read:hydra.builder or scope manifests:read)
curl -s "$HYDRA/api/manifests/workflows" -H "Authorization: Bearer $TOKEN"
# one manifest as YAML; the hash is in the X-Hydra-Manifest-SHA256 header
curl -si "$HYDRA/api/manifests/workflows/triage/1.0.0" -H "Authorization: Bearer $TOKEN"
# plan an apply without writing anything
curl -s -X POST "$HYDRA/api/manifests/apply?dry_run=true" \
-H "Authorization: Bearer $TOKEN" --data-binary @triage.yaml
GET /api/manifests/{agents|workflows}/{slug}[/{version}] akzeptiert ?format=json. POST /api/manifests/apply akzeptiert außerdem mode=deploy|draft, environment=<slug> und review_token=<slug>:<token>. Eine Bereitstellung über diesen Endpunkt wird nur in der Standard-Umgebung der Organisation akzeptiert und nur dann, wenn diese eine direkte Bereitstellung zulässt. Jedes Element wird zuerst geplant; wird eines abgelehnt, wird nichts geschrieben. Der Datenkörper ist auf 4 MiB begrenzt.
In einer Umgebung bereitstellen oder hochstufen
POST /api/environments/{slug}/deployments funktioniert sowohl für lokale als auch für Remote-Umgebungen.
curl -s -X POST "$HYDRA/api/environments/staging/deployments" \
-H "Authorization: Bearer $JWT" -H "Content-Type: application/json" \
-d '{
"from": "development",
"items": [{"kind": "workflow", "slug": "triage", "version": "1.0.0"}],
"reason": "QA sign-off",
"change_reference": "CR-1234",
"dry_run": true
}'
Die Antwort enthält eine status (planned für einen Testlauf), die release und pro Element einen Eintrag mit einer action (create, update, unchanged oder refused). Senden Sie denselben Text mit "dry_run": false, um die Bereitstellung durchzuführen.
Was wird geprüft?
| Überprüfen | Versagen |
|---|---|
| Sie können jeden Artikel exportieren. | 403 cannot export ... |
Es existiert eine Route from → target, und from wird vergeben, wenn Routen zum Ziel führen. | 422 there is no promotion route ..., environment ... is reached by promotion only |
Jedes Element wird in from bereitgestellt, und zwar in derselben Version. | 409 ... is not deployed in ..., ... runs <slug>@<version>, not ... |
Der Hash entspricht dem, was from läuft | 409 ... differs from what ... runs |
| Eine Änderungsreferenz, wenn die Richtlinie dies erfordert. | 422 environment "..." requires a change reference |
| Die Instanz verfügt über einen Signaturschlüssel | 503 this instance has no signing key (...); it cannot sign releases |
| Die Umwelt ist aktiv | 409 archiviert |
Eine Beförderung innerhalb desselben Vorgangs wird abgelehnt (422). Die Prüfungen werden erneut durchgeführt, sobald eine zurückgehaltene Freigabe endgültig genehmigt wird. Falls sich während der Wartezeit etwas geändert hat, schlägt die Freigabe fehl und es kommt zu keiner Änderung.
Remote-Umgebungen
Eine Remote-Umgebung ist mit POST /api/environments und "location": "remote", einem remote. Objekt (base_url, key_id, environment) und einem token registriert. Jede Instanz benötigt einen Ed25519-Signaturschlüssel (HYDRA_INSTANCE_SIGNING_KEY_FILE) und ENCRYPTION_MASTER_KEY. GET /api/instance ist öffentlich und zeigt die Instanz-ID und den Fingerabdruck des Schlüssels (key_id); die beiden Administratoren vergleichen die Fingerabdrücke außerhalb des regulären Datenverkehrs.
Die Quelle sendet die signierte Version an das Zielsystem POST /api/deployments/receive mithilfe eines Tokens mit Gültigkeitsbereich deployments:write Das Zielsystem akzeptiert nur Schlüssel von einer Quelle, denen sein Administrator vertraut (GET /api/instance/trust, dann POST /api/instance/trust/{id}/trust oder revoke). Der erste Push von einem unbekannten Schlüssel führt zu Fehler pending_trust; vertrauen Sie dem Schlüssel auf dem Zielsystem und stellen Sie die Version erneut bereit. Anmeldeinformationen werden niemals in der Version übertragen: Das Zielsystem verwendet eigene Variablen und Konnektoren.
Beförderungsstatus
Auf der Quellseite verwenden die Bereitstellungsantwort und der Freigabedatensatz diese Status:
| Status | Bedeutung |
|---|---|
planned | Nur Trockenlauf |
pending_trust | Das Ziel vertraut dem Quellschlüssel noch nicht. |
pending_approval | Zur Genehmigung zurückgestellt (HTTP 202) |
applied | Angewendet; für ein entferntes Ziel wurde ein Empfangsbeleg geprüft |
refused | Eine Überprüfung ist fehlgeschlagen; es hat sich nichts bewegt. |
unknown | Die Anfrage wurde nicht abgeschlossen. Überprüfen Sie, welche Prozesse auf dem Zielsystem ausgeführt werden, bevor Sie die Bereitstellung erneut durchführen. |
Auf dem Zielsystem verwendet der Posteingang für Genehmigungen (GET /api/deployments/pending[?status=]) pending, applied, rejected, expired und failed.
Genehmigungen
Eine Freigabe wird zurückgehalten, wenn die Richtlinien der Zielumgebung Genehmigungen erfordern, eine direkte Bereitstellung nicht zulassen oder die Umgebung geschützt ist. In den beiden letztgenannten Fällen ist mindestens eine Genehmigung erforderlich.
curl -s "$HYDRA/api/deployments/pending?status=pending" -H "Authorization: Bearer $JWT"
curl -s -X POST "$HYDRA/api/deployments/pending/$SOURCE_INSTANCE/$RELEASE_ID/approve" \
-H "Authorization: Bearer $JWT" -H "Content-Type: application/json" -d '{"comment":"Reviewed"}'
Vom Server durchgesetzte Regeln:
- Genehmiger besitzen die Genehmigungsberechtigung der Umgebung (Standardwert
approve:hydra.promotion). - Jede Person entscheidet einmal (409
you already decided on this release; another approver is needed). - Der Anfragende konnte die Anfrage nicht genehmigen (403
the requester cannot approve their own release). Die API-Token konnten die Anfrage nicht genehmigen (403releases are approved by people, not API tokens). - Die letzte erforderliche Genehmigung prüft die Freigabe erneut und wendet sie an. Jede Ablehnung beendet den Vorgang.
- Eine zurückgehaltene Freigabe verfällt nach Ablauf der in der Richtlinie festgelegten Frist
approval_ttl_hours; der Standardwert ist 72.
Bei einem entfernten Ziel erfasst die Quelle das Ergebnis mit POST /api/environments/{slug}/releases/{id}/refresh. Sehen Sie, was in einer Umgebung ausgeführt wird, mit GET /api/environments/{slug}/deployments und den Push-Verlauf mit GET /api/environments/{slug}/releases.
Rückwärts
Es gibt keine Rollback-Funktion. Workflows werden über den normalen Genehmigungsweg erneut bereitgestellt. Agenten haben jeweils nur eine aktive Version. Daher veröffentlichen Sie eine neue Agentenversion mit den vorherigen Inhalten und stellen diese bereit.
Grenzen
- Durch eingehende Trigger (z. B. HL7 über MLLP) und andere interne Pfade gestartete Ausführungen verwenden keine Umgebungsvariablen. Sie nutzen die Instanzkonfiguration und die aktuellen Versionen.
- Ein Agent kann in einer lokalen Umgebung nur in seiner Live-Version bereitgestellt werden. Eine spätere Änderung wird als Drift erkannt, und Ausführungen dieses Agents werden dort verweigert, bis er erneut bereitgestellt wird.
- Nur Push: Das Ziel muss von der Quelle über HTTPS erreichbar sein.
manage:hydra.environment, erforderlich für die Verwaltung von Umgebungen und die Bereitstellung, und die Standardgenehmigungsberechtigungapprove:hydra.promotionsind nicht im Berechtigungskatalog des Authentifizierungsdienstes aufdeventhalten (ich habe danach gesucht), sodass in der Praxis nur Superuser Umgebungen verwalten können.- Ein Release-Gate (die Richtlinie
required_gate_profile, dargestellt als Required compliance gate) kann eine lokale Bereitstellung blockieren oder ablehnen. Eine abgeschottete Umgebung lehnt Releases ab, die von einer anderen Instanz empfangen werden (environment "..." has a release gate; releases into it are deployed on this instance, not received, 422). Ich habe dies im Quellcode gelesen, aber nicht ausgeführt.
Verwandt
- Run on Mesh: Ausführung über verschiedene Standorte hinweg
- Tiet · Studio Builder: das Menü „Bereitstellen“
- Administration: Organisationsumgebungen in der Admin-Konsole
Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..