archi bot Produktdokumentation

Diese Übersetzung wurde maschinell erstellt (Beta). Maßgeblich ist die englische Anleitung.

Tägliche Arbeit

Arbeitsbereiche verwalten

Verwenden Sie Meine Arbeitsbereiche, um Arbeitsbereiche zu starten, zu stoppen, zu aktualisieren, zu öffnen, zu planen, zu prüfen und zu löschen, ohne Console zu verlassen.

KundenadministratorenKundenmitgliederPlattformbetreiber

Zuletzt aktualisiert

Raster „Meine Arbeitsbereiche" mit laufenden, gestoppten, veralteten und fehlerhaften Zeilen sowie Aktionsschaltflächen pro Zeile.
Von Console gerendertes Beispiel mit sicheren Daten: Jede Zeile hält ihren Status sichtbar und bietet Starten, Stoppen, Browser und Überlaufaktionen aus demselben Raster.

Meine Arbeitsbereiche ist die Startseite von Console (Route /). Sie listet jeden Arbeitsbereich auf, den Sie sehen können, hält wichtige Gesamtwerte im Blick und gibt jeder Zeile die Aktionen, die Sie für die tägliche Arbeit benötigen: starten, stoppen, aktualisieren, einen Editor öffnen, Protokolle anzeigen, den Zeitplan bearbeiten, Details prüfen und löschen.

Wenn Sie noch keinen Arbeitsbereich erstellt haben, beginnen Sie mit Den ersten Arbeitsbereich erstellen.

Das Raster lesen

Raster „Meine Arbeitsbereiche" mit laufenden, gestoppten, veralteten und fehlerhaften Zeilen

Die Kopfzeile zeigt Meine Arbeitsbereiche mit einer Anzahl wie „4 von 4 angezeigt” und einer Abfrage-Anzeige, während Console den Status aktualisiert. Über die Kopfzeile können Sie Arbeitsbereich erstellen, die Prüfung der Ruhezustandsrichtlinie (Betreiber) und Aktualisieren öffnen.

Unter der Kopfzeile befinden sich drei Registerkarten:

RegisterkarteWas sie macht
ArbeitsbereichsrasterDie Hauptliste mit Aktionen pro Zeile. Wechseln Sie zwischen Tabelle und Karten, wählen Sie Spalten oder Ansicht zurücksetzen.
Arbeitsbereichsliste filternSuchen und filtern Sie nach Status, Eigentümer, Vorlage, Ziel, Quelle und Aktualisierungsstatus.
FlottenübersichtGesamtwerte, die sich mit dem aktuellen Bestand und dem Filterzustand aktualisieren.

Jede Zeile hält ihren Status sichtbar, sodass Sie handeln können, ohne einen anderen Bildschirm zu öffnen.

StatusBedeutungÜbliche Aktion
LäuftDie Laufzeit ist aktiv.Im Browser öffnen oder Stoppen, wenn fertig.
GestopptDie Laufzeit ist nicht aktiv.Starten vor der Arbeit, oder löschen, wenn nicht mehr benötigt.
Startet oder aktualisiert (Aktiver Build)Ein Build läuft.Auf das Ergebnis warten oder Build abbrechen.
RuhendInaktiv über das Ruhezustandsfenster des Kunden hinaus.Starten, um ihn wieder zu aktivieren.
Fehlgeschlagen oder fehlerhaftEin Build oder die Laufzeit benötigt eine Prüfung.Protokolle oder Support öffnen, bevor Speicher gelöscht wird.

Gestoppte, ruhende und fehlerhafte Arbeitsbereiche bleiben im Raster, sodass Sie sie an derselben Stelle neu starten, aktualisieren, prüfen oder löschen können.

Einen gestoppten oder ruhenden Arbeitsbereich starten

  1. Öffnen Sie Meine Arbeitsbereiche und finden Sie die gestoppte oder ruhende Zeile.
  2. Klicken Sie auf die Aktion Starten in dieser Zeile.
  3. Warten Sie, bis der Status auf läuft wechselt. Das Raster fragt automatisch ab.
  4. Klicken Sie auf Browser, um den Editor im Browser zu öffnen.

Starten erstellt den Arbeitsbereich nicht neu. Es bringt die vorhandene Laufzeit mit dem Speicher und Inhalt, den sie bereits hatte, wieder online. Ruhende Zeilen verwenden dieselbe Aktion, um sich wieder zu aktivieren.

Einen laufenden Arbeitsbereich stoppen

  1. Finden Sie die laufende Zeile in Meine Arbeitsbereiche.
  2. Klicken Sie auf Stoppen.
  3. Bestätigen Sie, dass der Status auf gestoppt wechselt.

Stoppen steuert die Laufzeitnutzung und unterscheidet sich vom Löschen. Speicher und der Arbeitsbereichsdatensatz bleiben gemäß der Plattformrichtlinie erhalten. Siehe Nutzung und Abrechnung, um zu erfahren, wie Laufzeitstunden gemessen werden.

Einen aktiven Build abbrechen

Wenn ein Build läuft, zeigt die Zeile Aktiver Build an und die meisten anderen Aktionen sind blockiert, bis er abgeschlossen ist.

  1. Klicken Sie auf Build abbrechen in der Zeile mit dem aktiven Build.
  2. Bestätigen Sie in Aktiven Build abbrechen mit Aktiven Build abbrechen, oder wählen Sie Build weiterlaufen lassen, um ihn unangetastet zu lassen.

Abbrechen stoppt den aktuellen Build, sodass eine andere Aktion „Starten”, „Stoppen”, „Aktualisieren” oder „Löschen” ausgeführt werden kann.

Einen Editor oder ein Laufzeitwerkzeug öffnen

Jede laufende Zeile hat eine Browser-Aktion für den Standard-Editor im Browser. Das Überlaufmenü („…”) in der Zeile enthält die anderen Öffnungsziele:

  • VS Code Desktop und JetBrains Gateway öffnen Editor-Deeplinks in Ihren lokalen Werkzeugen.
  • SSH-Konfiguration gibt Ihnen eine erweiterte Terminal- oder Editorverbindung.
  • Remotedesktop öffnet RDP-Verbindungsdetails für Windows-Arbeitsbereiche (einige Windows-Arbeitsbereiche öffnen Remotedesktop stattdessen im Browser).
  • Tomcat öffnet den Anwendungsendpunkt für Arbeitsbereiche, die einen bereitstellen.

Browser ist der Standardweg für die meisten Benutzer. Das vollständige Öffnungsmenü mit VS Code Desktop, JetBrains Gateway, SSH-Konfiguration, Remotedesktop und Tomcat, gruppiert unter dem Überlaufsteuerelement, wird hier nicht gezeigt; öffnen Sie das „…”-Menü in einer beliebigen laufenden Zeile, um es zu sehen.

Arbeitsbereiche, die eine Git-Health-Prüfung bereitstellen, zeigen außerdem eine Git Health-Aktion, sodass Sie den Repository-Status bestätigen können, ohne ein Terminal zu öffnen.

Remotedesktop für Windows-Arbeitsbereiche

Für Windows-Arbeitsbereiche öffnet Remotedesktop einen Dialog mit der RDP-Adresse, die in Microsoft Remote Desktop geöffnet werden soll, sobald der Tunnel bereit ist, sowie den Befehl, der auf dem Computer ausgeführt werden soll, auf dem Ihr RDP-Client installiert ist. Remotedesktop bleibt privat innerhalb des Arbeitsbereich-Tunnels; geben Sie RDP (Port 3389) nicht im öffentlichen Internet frei. Dieser Dialog wird hier nicht gezeigt.

Sicher aktualisieren

Verwenden Sie eine Aktualisierung, wenn Sie neu eingebackene Editor-Werkzeuge, Aktualisierungen der Archibot-Erweiterung, code-server-Aktualisierungen oder Verbesserungen der Arbeitsbereichslaufzeit benötigen. Laufende Arbeitsbereiche behalten den Image-Inhalt, mit dem sie gestartet sind, bis sie aktualisiert oder neu erstellt werden.

  1. Klicken Sie auf Aktualisieren in einer Zeile, die Aktualisierung verfügbar anzeigt.
  2. Console öffnet Parameter prüfen und lädt den Aktualisierungsplan.
  3. Vergleichen Sie Aktuelle Version und Aktive Version und lesen Sie die Aktualisierungsgründe.
  4. Bestätigen Sie den Hinweis zur Anmeldedaten-Aktualisierung: Verwaltete Anmeldedaten werden aktualisiert, ohne geheime Werte offenzulegen, und Geheime Werte ausgeblendet bleibt bestehen.
  5. Prüfen Sie die Tabelle Parameter. Passen Sie jeden Wert an, der als Wird geändert oder Beibehalten gekennzeichnet ist; verwaltete Felder bleiben ausgeblendet.
  6. Klicken Sie nur dann auf Aktualisierung ausführen, wenn der Plan korrekt ist, oder auf Schließen, um abzubrechen.

Dialog „Parameter prüfen" mit Versionskarten, Anmeldedaten-Aktualisierung und einer Parametertabelle

Anpassbare Werte werden von der aktiven Vorlage validiert, bevor die Aktualisierung beginnt, also beheben Sie jeden Feldfehler in der Prüfung, anstatt den Build wiederholt zu starten. Die Aktualisierung startet einen Arbeitsbereich-Build erst, nachdem die serverseitige Validierung bestanden wurde, und öffnet dann das Build-Protokoll.

Den Zeitplan bearbeiten

Der Zeitplan steuert, wann ein Arbeitsbereich von selbst startet und stoppt.

  1. Öffnen Sie die Aktion Zeitplan in einer Zeile.
  2. Prüfen Sie die aktuellen Karten Status, Auto-Stopp und Auto-Start.
  3. Verwenden Sie eine Voreinstellungsauswahl (Manuell, Arbeitstag, Tägliche QA), um eine bekannte Form festzulegen, und passen Sie dann die Felder an.
  4. Legen Sie den Auto-Start-Zeitplan fest (leer lassen, um Auto-Start zu deaktivieren) und Auto-Stopp nach Start in Stunden.
  5. Legen Sie optional Automatische Aktualisierungen und eine Neue aktive Frist fest.
  6. Klicken Sie auf Zeitplan anwenden oder auf Schließen, um zu verwerfen.

Arbeitsbereich-Zeitplandialog mit Statuskarten, Voreinstellungen, Auto-Start-cron und Auto-Stopp-Stunden

Die Einstellungen für Auto-Start, Auto-Stopp, Ruhezustand, aktive Frist und automatische Aktualisierung werden auf die Arbeitsbereichslaufzeit angewendet, sobald Sie sie anwenden.

Auto-Stopp überwachen und verlängern

Das Raster enthält eine Spalte Auto-Stopp in, die zeigt, wie lange es dauert, bis jeder laufende Arbeitsbereich von selbst stoppt, mit der genauen Stoppzeit darunter. Ein Arbeitsbereich ohne Auto-Stopp-Frist zeigt „—”. Sortieren Sie nach der Spalte, um die Arbeitsbereiche zu finden, die am frühesten stoppen.

Um einen Arbeitsbereich länger laufen zu lassen, ohne den vollständigen Zeitplan-Editor zu öffnen, verwenden Sie Auto-Stopp verlängern:

  • Öffnen Sie im Raster das „…”-Menü einer laufenden Zeile und wählen Sie Auto-Stopp verlängern +1h oder +4h.
  • Verwenden Sie in Details die Schaltflächen +1h / +4h / +8h neben der Auto-Stopp-Zeit.

Jede Verlängerung schiebt die aktive Frist über ihren aktuellen Wert hinaus (oder ab jetzt, wenn keine festgelegt ist) und aktualisiert die Zeile. Sie ändert nur den aktuellen Lauf; der wiederkehrende Auto-Stopp, den Sie in Den Zeitplan bearbeiten festlegen, bleibt gleich.

Arbeitsbereichsraster mit der Spalte „Auto-Stopp in" und einem Zeilenaktionsmenü mit Optionen zum Verlängern des Auto-Stopps.

Details prüfen

Die Aktion Details öffnet eine schreibgeschützte Momentaufnahme sowie einen Ort, um Console-Notizen zu führen.

  1. Öffnen Sie Details in der Zeile, die Sie prüfen möchten.
  2. Prüfen Sie die Karten Status, Agent, Eigentümer, Betriebszeit, Auto-Stopp in, Vorlage, Ziel, Aktualisiert, Quelle und Git Health.
  3. Verwenden Sie die Öffnungszeile (Browser, VS Code Desktop, Tomcat, Protokolle, Support), um direkt zu einem Werkzeug zu springen.
  4. Legen Sie optional einen Anzeigenamen und einen Kommentar für diesen Arbeitsbereichsdatensatz fest und klicken Sie dann auf Details speichern.

Arbeitsbereich-Detaildialog mit Statuskarten, Öffnungsschaltflächen, Anzeigename und Kommentarfeldern

Der Anzeigename gilt nur für Console; lassen Sie ihn leer, um den Arbeitsbereichsnamen anzuzeigen. Verwenden Sie den Kommentar für Bereitstellungsnotizen, Eigentümerkontext oder Erinnerungen zur Nachverfolgung.

Protokolle anzeigen

Wenn ein Build fehlschlägt oder die Laufzeit falsch aussieht, öffnen Sie Protokolle aus der Zeile oder aus Details.

  • Der Modus Runtime verfolgt den Hauptprotokollstrom des Agenten für den Arbeitsbereich.
  • Der Modus Build zeigt die neueste Build-Ausgabe.

Verwenden Sie die Neuladen- und Download-Steuerelemente, um das aktuelle Protokoll zu aktualisieren oder als Text zu speichern.

Arbeitsbereich-Support öffnen

Verwenden Sie Support, wenn eine Zeile einen fehlgeschlagenen, fehlerhaften oder unklaren Laufzeitstatus anzeigt.

  1. Öffnen Sie Support in der Arbeitsbereichszeile oder aus Details.
  2. Prüfen Sie die oberen Karten: Arbeitsbereich, Ziel, Build und Laufzeitagenten.
  3. Überprüfen Sie Integritätsprüfungen (Arbeitsbereichsagent, neuester Build, Laufzeit-Pod), Laufzeitagenten, Speicher, Freigegebenes Laufwerk, Verwalteter Zugriff, Arbeitsbereichsintegrationen und Nutzung.
  4. Verwenden Sie Laufzeitprotokolle oder Build-Protokolle, um tiefer zu graben, oder Arbeitsbereich aktualisieren, wenn Sie aufgefordert werden, eine beschreibbare Einbindung des freigegebenen Laufwerks anzuhängen.

Arbeitsbereich-Support-Panel mit Integritätsprüfungen, Laufzeitagenten, Speicher und Nutzungskarten

Nur Personen mit Arbeitsbereichszugriff können diese Support-Details sehen. Das Support-Panel ist der richtige Ort, um Fakten zu sammeln, bevor eine Support-Übergabe erfolgt.

Einen Arbeitsbereich löschen

Löschen Sie nur, wenn Sie den verwalteten Arbeitsbereich absichtlich entfernen möchten.

  1. Öffnen Sie die Aktion Löschen in der Zeile.
  2. Lesen Sie in Arbeitsbereich löschen, was entfernt wird: der Archibot-Arbeitsbereich und seine verwalteten Laufzeitressourcen. Dies kann von Console aus nicht rückgängig gemacht werden.
  3. Geben Sie den genauen Arbeitsbereichsnamen zur Bestätigung ein. Die Löschschaltfläche wird erst aktiviert, nachdem der Name übereinstimmt.
  4. Bestätigen Sie die Löschung.

Löschen Sie für eine normale Kundenlöschung keine PVCs, Pods, Kubernetes-Secrets oder Arbeitsbereich-Laufzeitobjekte manuell. Verwenden Sie die Console-Löschaktion, damit die Bereinigung dem unterstützten Pfad folgt. Wenn die Bereinigung festzustecken scheint, fügen Sie den Arbeitsbereichsnamen, den Status und die letzte Aktion in Ihre Support-Übergabe ein.

Sammelaktionen

Wenn Sie mehrere Zeilen mit den Zeilenkontrollkästchen auswählen, zeigt Console eine Sammelaktionsleiste mit der ausgewählten Anzahl an.

  • Wählen Sie Starten, Stoppen, Aktualisieren, Builds abbrechen oder Löschen.
  • Jede Aktion gilt nur für ausgewählte Arbeitsbereiche, die dafür infrage kommen; Console zeigt eine Anzahl der infrage kommenden an.
  • Das Sammellöschen erfordert die Eingabe von DELETE zur Bestätigung. Die Sammellöschbestätigung wird hier nicht gezeigt.
  • Console führt den Vorgang für jeweils einen Arbeitsbereich aus und hält fehlgeschlagene Zeilen ausgewählt, sodass Sie es erneut versuchen können.

Verwenden Sie Löschen, um die aktuelle Auswahl zu verwerfen.

Ruhezustandsrichtlinie (Betreiber)

Plattformbetreiber können die Ruhezustandsrichtlinie über die Kopfzeile öffnen, um inaktive Arbeitsbereiche anhand des Bereinigungsfensters jedes Kunden zu prüfen.

  1. Öffnen Sie die Ruhezustandsrichtlinie.
  2. Prüfen Sie die Zähler: Geprüft, Kandidaten, Ruhend, Löschen, Fehlend und Angewendet.
  3. Legen Sie unter Kundenrichtlinien-Einrichtung die Tage für Als ruhend markieren nach und Ruhend löschen nach fest (Voreinstellungen decken übliche Fenster wie 30 / 90 ab), dann Richtlinie speichern.
  4. Wählen Sie Ruhend-Markierungen anwenden, Ruhend-Löschungen anwenden oder Fehlende löschen, dann Vorschau vor Ruhezustandsaktionen anwenden.

Prüfung der Arbeitsbereich-Ruhezustandsrichtlinie mit Zählern, Tageseinstellungen pro Kunde und Kandidatenzeilen

Der Ruhezustand ist nur eine Bereinigungs- und Inaktivitätsrichtlinie; der Auto-Start-cron und die Auto-Stopp-Stunden liegen im Zeitplan jedes Arbeitsbereichs. Richtlinienaktionen werden erst zu Kandidaten, nachdem das Kundenkonto über ein Ruhezustandsfenster verfügt, und diese Werte liegen ebenfalls in Zugriff unter Kunden, Plan. Aktionen der Ruhezustandsrichtlinie erfordern Plattformbetreiber-Zugriff.

Verwandte Anleitungen

Fertig, wenn

  • Die Arbeitsbereichszeile zeigt den erwarteten Status.
  • Starten ist für gestoppte oder ruhende Arbeitsbereiche verfügbar.
  • Stoppen ist für laufende oder startende Arbeitsbereiche verfügbar.
  • Parameter prüfen wird abgeschlossen, bevor ein Build beginnt.
  • Die Löschbestätigung stimmt mit dem Arbeitsbereich überein, den Sie entfernen möchten.