Hostly

Hostly Registry ​

Die Hostly Registry ist Hostlys privater Speicher für Container-Images. Dort kannst du Images direkt bei dem Workspace ablegen, in dem du sie verwenden möchtest.

Die Registry speichert Images, erstellt oder startet sie aber nicht. Ein Image wird erst dann zu einer laufenden Anwendung, wenn du seine Referenz in einem Hostly-Deployment verwendest.

text
Image erstellen -> in die Hostly Registry pushen -> als Hostly-Service deployen

So sind Registry-Inhalte organisiert ​

Hostly organisiert Registry-Inhalte nach Workspace:

text
Hostly Registry
└── Workspace-Repository
    ├── Image
    │   ├── Tag
    │   └── weiterer Tag
    └── verschachteltes/Image
        └── Tag

Registry ​

Die Registry ist der Dienst, der alle Hostly-Images speichert. Ihre Adresse lautet:

text
registry.hostly.ninja

Workspace-Repository ​

Jeder Workspace besitzt ein eigenes Repository in der Registry. Der Name des Repositorys entspricht immer dem Workspace-Slug. Dadurch bleiben die Images verschiedener Workspaces voneinander getrennt.

Für einen Workspace mit dem Slug acme beginnt das Repository mit:

text
registry.hostly.ninja/acme

Hostly bezeichnet diesen zum Workspace gehörenden Teil der Image-Referenz als Repository. Andere Container-Registry-Werkzeuge verwenden dasselbe Wort teilweise für den vollständigen Pfad nach dem Registry-Host.

Image und Tag ​

Ein Image ist ein benanntes Container-Image innerhalb des Workspace-Repositorys. Image-Namen können aus mehreren Pfadsegmenten bestehen, zum Beispiel backend/api.

Ein Tag ist eine Bezeichnung für eine bestimmte Version eines Images. Ein Image kann mehrere Tags besitzen, zum Beispiel 1.4.2, stable und latest.

Eine Hostly-Image-Referenz lesen ​

Eine vollständige Image-Referenz enthält Registry, Workspace-Repository, Image-Namen und Tag:

text
registry.hostly.ninja/acme/api:1.4.2
|-------------------| |--| |-| |---|
      Registry        Repo Image  Tag

Ein verschachtelter Image-Name funktioniert genauso:

text
registry.hostly.ninja/acme/backend/api:1.4.2

Die Registry-Seite in Hostly zeigt dir die richtige Registry-Adresse und kopierbare Referenzen für deine Images und Tags.

Tags können sich ändern ​

Ein Tag ist eine veränderliche Bezeichnung. Wenn du neue Image-Inhalte mit einem vorhandenen Tag pushst, verweist dieser Tag anschließend auf die neue Version.

Verwende für vorhersehbare Deployments möglichst versionierte Tags wie 1.4.2. Ein allgemeiner Tag wie latest kann während der Entwicklung nützlich sein, aktualisiert einen laufenden Service aber nicht automatisch. Hostly verwendet die Image-Version, auf die der Tag beim Start der Container verweist. Wenn du einen Tag danach in der Registry änderst, ändert sich der laufende Service nicht. Ein Neustart oder ein neues Deployment übernimmt die neue Version.

Logincodes und Registry-Sessions ​

Du benötigst eine Registry-Session, um Images in die Hostly Registry zu pushen oder aus ihr zu pullen.

Der Login-Ablauf verwendet zwei unterschiedliche Zugangsdaten:

  1. Hostly erstellt einen kurzlebigen, einmalig verwendbaren Logincode.
  2. Du verwendest das angezeigte Docker-Login-Kommando und gibst den Code als Passwort ein.
  3. Der Docker-Client erstellt eine Registry-Session, die auch nach Ablauf des Logincodes nutzbar bleibt.

Behandle den Logincode wie ein Passwort. Er ist geheim, kann nur einmal verwendet werden und läuft nach wenigen Minuten ab.

Eine Registry-Session gehört zu deinem Hostly-Account. Der Zugriff auf Repository-Inhalte richtet sich nach deinen aktuellen Workspace-Berechtigungen. Hostly zeigt aktive Sessions zusammen mit Details wie Erstellungsdatum, letzter Verwendung, Client und IP-Adresse an.

Widerrufe eine Session, wenn du den Client nicht mehr verwendest oder ihn nicht erkennst. Der Widerruf verhindert, dass diese Session ihren Registry-Zugriff erneuert. Images und andere Sessions bleiben davon unberührt.

Speicher und Löschen ​

Die Registry-Übersicht zeigt, wie viel Registry-Speicher der Workspace verwendet und welches Limit aktuell gilt. Images können gespeicherte Daten gemeinsam verwenden. Addiere deshalb nicht die für einzelne Images oder Tags angezeigten Größen, um den Gesamtverbrauch zu berechnen.

Beim Löschen gibt es zwei unterschiedliche Bereiche:

AktionAuswirkung
Tag löschenEntfernt diesen Tag vom Image. Andere Tags bleiben verfügbar.
Image löschenEntfernt das Image mit allen seinen Tags.
Session widerrufenEntfernt den Registry-Zugriff dieses Clients, ohne Image-Inhalte zu löschen.

Das Löschen eines Images oder Tags kann nicht rückgängig gemacht werden. Pushe den Inhalt erneut, wenn du ihn später wieder benötigst.

Registry und Deployment sind getrennt ​

Das Pushen eines Images speichert es nur in der Registry. Dadurch wird kein Hostly-Service erstellt und kein bestehender Service aktualisiert.

Um das Image auszuführen, kopierst du seine vollständige Referenz von der Registry-Seite und verwendest sie in einem Deployment. Das Deployment bestimmt den laufenden Service, seinen Container-Port, seine Domain, seine Ressourcen und seine Laufzeitkonfiguration.

Verwandte Konzepte ​