Erstellen und Verwalten von AI Model Experiments-Instanzen
Zuletzt aktualisiert am
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“Bevor Sie eine Instanz erstellen, stellen Sie sicher, dass Ihre Umgebung die folgenden Voraussetzungen erfüllt:
- Sie haben ein STACKIT Kundenkonto: Kundenkonto erstellen
- Sie haben ein STACKIT Benutzerkonto: Benutzerkonto erstellen
- Sie haben ein STACKIT Projekt: Projekte erstellen
Instanzen verstehen
Abschnitt betitelt „Instanzen verstehen“In AI Model Experiments ist eine Instanz eine dedizierte MLflow™ Tracking Server-Umgebung, die sicherstellt, dass Ihr Machine-Learning-Lebenszyklus organisiert und sicher ist. Jede Instanz arbeitet mit einer eigenen unabhängigen Datenbank für Metadaten (Parameter, Metriken, Tags) und dediziertem Speicher für Artefakte (Modelle, Plots, Daten). Daher können Instanzen verwendet werden, um Grenzen zwischen verschiedenen Teams, Projekten oder Entwicklungsphasen zu ziehen.
Jede Instanz ist über eine eindeutige URL erreichbar. Sie können sich direkt mit Ihrem STACKIT Konto anmelden, um die MLflow™-Benutzeroberfläche anzuzeigen und Experimente zu inspizieren. Um programmgesteuert mit einer Instanz zu interagieren (über das MLflow™-Python-SDK oder die REST-API), müssen Sie Zugriffstoken generieren, wie in Token für AI Model Experiments verwalten erklärt. Diese Token ermöglichen es Ihnen, Ihre lokalen Umgebungen oder CI/CD-Pipelines sicher am Server zu authentifizieren.
Um das Speichern von Artefakten zu erleichtern, wird für jede von Ihnen erstellte Instanz automatisch ein dedizierter Object Storage Bucket in Ihrem Projekt erstellt. Da Instanzen auf diesen Buckets basieren, muss STACKIT Object Storage in Ihrem Projekt aktiviert sein, bevor Sie AI Model Experiments aktivieren können.
Um Ihre Speicherkosten optimiert und Ihren Arbeitsbereich sauber zu halten, enthalten Instanzen eine benutzerdefinierte Einstellung namens DeletedExperimentRetention. Wenn Sie ein Experiment in der MLflow™-Benutzeroberfläche oder über die API löschen, werden die Daten zunächst nur “zum Löschen markiert” (Soft Delete). Diese Einstellung definiert eine Kulanzspanne, bevor diese Daten endgültig aus der Datenbank und dem Artefaktspeicher gelöscht werden. Wenn Sie keinen Wert angeben, beträgt die Aufbewahrungsfrist standardmäßig 30 Tage. Sie können diesen Zeitraum anpassen, um den spezifischen Datenrichtlinien Ihres Teams zu entsprechen oder um Speicherplatz freizugeben.
Instanz erstellen
Abschnitt betitelt „Instanz erstellen“- Klicken Sie in der Seitenleiste auf AI Model Experiments.
- Klicken Sie in der oberen Leiste auf AI Model Experiments erstellen.
- Geben Sie einen Instanznamen und optional eine Beschreibung sowie eine DeletedExperimentRetention ein.
- Klicken Sie auf Zahlungspflichtig bestellen.
Um eine Instanz über die API zu erhalten, benötigen Sie ein Auth-Token für Ihren Benutzer oder für Ihr Servicekonto. Um dieses vom Auth-Token für den AI Model Experiments Tracking Server zu unterscheiden, nennen wir es STACKIT Auth-Token. Die folgende Tabelle gibt Ihnen einen vollständigen Überblick über alle Parameter:
| Parameter | Bedeutung | Beispiel |
|---|---|---|
| stackit-auth-token | Auth-Token für Benutzer oder Servicekonto | BZasjkdasbu… |
| project-id | Die ID Ihres Projekts | 89783241-32… |
| region-id | Die ID der Region | eu01 |
| instance-description | Beschreibung des Zwecks der Instanz | Meine Instanz |
| instance-name | Name der Instanz | meine-instanz |
| experiment-retention | Gewünschte Aufbewahrungsfrist gelöschter Experimente | 30d |
curl -X POST [https://model-experiments.api.stackit.cloud/v1alpha/projects/](https://model-experiments.api.stackit.cloud/v1alpha/projects/)[project-id]/regions/[region-id]/instances \--header "Authorization: Bearer [stackit-auth-token]" \--header "Content-Type: application/json" \--data '{"description": "[instance-description]", "name": "[instance-name]", "deletedExperimentRetention": "[experiment-retention]"}'Instanzen auflisten
Abschnitt betitelt „Instanzen auflisten“- Klicken Sie in der Seitenleiste auf AI Model Experiments.
- Sie sehen eine Liste aller Instanzen. Klicken Sie auf eine Instanz, um den Detailbereich anzuzeigen.
Um eine Liste aller verfügbaren Instanzen zu erhalten, führen Sie den folgenden API-Aufruf aus:
| Parameter | Bedeutung | Beispiel |
|---|---|---|
| stackit-auth-token | Auth-Token für Benutzer oder Servicekonto | BZasjkdasbu… |
| project-id | Die ID Ihres Projekts | 89783241-32… |
| region-id | Die ID der Region | eu01 |
curl -X GET [https://model-experiments.api.stackit.cloud/v1alpha/projects/](https://model-experiments.api.stackit.cloud/v1alpha/projects/)[project-id]/regions/[region-id]/instances \--header "Authorization: Bearer [stackit-auth-token]"Instanzen aktualisieren
Abschnitt betitelt „Instanzen aktualisieren“- Klicken Sie in der Seitenleiste auf AI Model Experiments.
- Sie sehen eine Liste aller Instanzen. Klicken Sie auf eine Instanz, um den Detailbereich anzuzeigen.
- Ändern Sie den gewünschten Eintrag.
- Klicken Sie auf Speichern, um die Instanz zu aktualisieren.
Um die Beschreibung, den Namen oder die deletedExperimentRetention einer Instanz zu ändern, verwenden Sie den folgenden API-Aufruf. Im gezeigten Beispiel wird die Beschreibung einer Instanz aktualisiert.
| Parameter | Bedeutung | Beispiel |
|---|---|---|
| stackit-auth-token | Auth-Token für Benutzer oder Servicekonto | BZasjkdasbu… |
| project-id | Die ID Ihres Projekts | 89783241-32… |
| region-id | Die ID der Region | eu01 |
| instance-id | Die ID Ihrer Instanz | 12345678-12… |
| instance-description | Beschreibung des Zwecks der Instanz | Meine Instanz |
curl -X PATCH [https://model-experiments.api.stackit.cloud/v1alpha/projects/](https://model-experiments.api.stackit.cloud/v1alpha/projects/)[project-id]/regions/[region-id]/instances/[instance-id] \--header "Authorization: Bearer [stackit-auth-token]" \--header "Content-Type: application/json" \--data '{"description": "[instance-description]"}'Instanzen löschen
Abschnitt betitelt „Instanzen löschen“- Klicken Sie in der Seitenleiste auf AI Model Experiments.
- Sie sehen eine Liste aller Instanzen. Klicken Sie auf die Schaltfläche mit den drei Punkten einer Instanz und dann auf Löschen, um den Löschbereich zu öffnen.
- Geben Sie den Namen der Instanz ein und klicken Sie auf Löschen, um die Instanz endgültig zu löschen.
Um eine Instanz zu löschen, verwenden Sie den folgenden API-Aufruf:
| Parameter | Bedeutung | Beispiel |
|---|---|---|
| stackit-auth-token | Auth-Token für Benutzer oder Servicekonto | BZasjkdasbu… |
| project-id | Die ID Ihres Projekts | 89783241-32… |
| region-id | Die ID der Region | eu01 |
| instance-id | Die ID Ihrer Instanz | 12345678-12… |
curl -X DELETE [https://model-experiments.api.stackit.cloud/v1alpha/projects/](https://model-experiments.api.stackit.cloud/v1alpha/projects/)[project-id]/regions/[region-id]/instances/[instance-id] \--header "Authorization: Bearer [stackit-auth-token]"