xCloud AI

Control-Plane · Placements, Training, Adapter, Agenten, Schlüssel, Verbrauch

v0.48.0 · API v1

CLI installieren

Ein statisches Binary ohne Abhängigkeiten. Der Installer erkennt Betriebssystem und Architektur, prüft die SHA256-Summe und legt xcloud nach ~/.local/bin. Client und Server sind derselbe Build.

curl -fsSL https://registry.xcloud-ai.devops.x-ion.org/install.sh | sh
xcloud login --server https://registry.xcloud-ai.devops.x-ion.org
DateiSystemGrößeSHA256
xcloud-darwin-amd64darwin/amd6438,0 MiB4aff9445390170477d708d90d8156827de1d82154d36c1b5b926a2d34b5b7a1d
xcloud-darwin-arm64darwin/arm6435,7 MiB87c1ba289d209122dc66fb6d724588dfcb867007cca87ff9b9861e48077b4ff5
xcloud-linux-amd64linux/amd6437,4 MiB244045b5554dbef545c92b85e9e9110a6417b79abbc4adb2bc326b8ebac306b8
xcloud-linux-arm64linux/arm6434,9 MiBcedf1acef738fe4f8231381dde318f5eb2ca45d7885dd852096ca81124245a3b
xcloud-windows-amd64.exewindows/amd6438,2 MiB8ce2c56d7076f205d735391ae4c86a202eb5ca087170922519f6522136280c61

Prüfsummen: SHA256SUMS · Liste als JSON: /download/ · Aktuell bleiben: xcloud update holt genau den Client dieser Control-Plane (xcloud update --check für Automation, Exit-Code 10 = Update verfügbar).

Terraform und OpenTofu

Placements, Adapter und Modelle als Code: der Provider kommt aus der Registry dieser Instanz, terraform init braucht keine Zugangsdaten. Dein Token gibst du als XCLOUD_TOKEN mit.

terraform {
  required_providers {
    xcloudai = {
      source = "registry.xcloud-ai.devops.x-ion.org/xcloud/xcloudai"
    }
  }
}

provider "xcloudai" {
  server = "https://registry.xcloud-ai.devops.x-ion.org" # token: XCLOUD_TOKEN
}

Schritt für Schritt vom Token bis zum laufenden Placement: Terraform-Tutorial. Für Bots und Agenten startet xcloud mcp serve einen MCP-Server mit Lese-, Diagnose- und Dry-Run-Werkzeugen.

Änderungen in v0.48.0

Logs sagen jetzt, wenn es nichts mehr zu lesen gibt. Ein Pod, der beendet ist und dessen Container der Knoten schon weggeräumt hat, hat kein Log mehr. Bis v0.24 kam an dieser Stelle der Fehlertext des Knotens als vermeintliche Engine-Ausgabe zurück (unable to retrieve container logs for containerd://…, Exit 0). Ab v0.25 antwortet die API mit HTTP 410 und einem Satz, der Pod, Container und Exit-Zeit nennt; xcloud pod logs beendet sich mit Exit 1.

WasBis v0.24Ab v0.25
Reihenfolge in pod list / Spalte PODSnach Namelaufende Pods zuerst, dann in Ablösung befindliche, beendete zuletzt; darin der neueste zuerst
Default-Pod von placement statusder erste nach Nameder erste laufende Pod; wechselt zum Ersatz, wenn er endet
placement logs / --replica Nbeendete Pods zählten mitnur laufende Pods, beendete sind erst die Antwort, wenn nichts anderes läuft
Log eines beendeten Pods, Container vom Knoten entfernt200 + Fehlertext des Knotens410 Gone

Keine Änderung an Bestellungen, Token oder Keys. Wer in v0.24 den Wechsel von --aiservice zu --tenant noch nicht nachgezogen hat: er gilt weiterhin. Aktualisieren mit xcloud update.

Status dieser Instanz

v0.48.0Server-Build
v1API-Vertrag
5CLI-Binaries im Build

Optionale Teilsysteme. Ein nicht konfiguriertes Teilsystem antwortet auf seinen Routen mit 501, nie mit Platzhalterdaten.

TeilsystemRoutenZustand
Browser-Login (SSO)/v1/auth/*aktiv
Modell-Katalog/v1/modelsaktiv
GPU-Kapazität/v1/compute/*aktiv
Verbrauch (Usage-Ledger)/v1/usageaktiv
Training-Logs/v1/training-jobs/{name}/logsaktiv
Preisliste/v1/pricingaktiv
CLI-Download/download/*, /install.shaktiv
Terraform-Registry/.well-known/terraform.json, /terraform/providers/v1/*aktiv

Was diese Adresse ist