Skip to main content

Website | Sla de container op in onze register - Save container to our registry

Press here to see the English version

Uitleg

Een register(Nederlands voor registry) wordt gebruikt om containers(ookwel images genoemd) op te slaan. Een container is een gestandardiseerde ingekapselde omgeving waar een applicatie in draait. Elke container draait hooguit één applicatie. Containers kunnen met elkaar communiseren door poorten te openen. Hieronder vind u instructies om in te loggen op onze register, project aan te maken, een contaier te uploaden naar het project en een robot account aan te maken om de container te kunnen downloaden. Als u een container/image heeft laten bouwen en de container/image upload heet dat ook wel pushen naar het register toe. Het downloaden van een container/image heet ook wel pullen van het register.

Inloggen

Om in te loggen moeten de volgende stappen ondernomen worden:

  1. Open een webbrowser
  2. Ga naar https://registry.webhosting.rug.nl
  3. Login met personeels-account(p-account)

Aanmake project

Om één of meerdere containers te kunnen uploaden(ookwel pushen genoemd) hebt u een project nodig om de containers in op te slaan. Om een project te kunnen aanmaken moet u zijn ingelogd. Hieronder staat uitgelegd hoe u een project kan aanmaken:

  1. Druk op + NEW PROJECT
  2. Vul het volgende in:
  • Project Name: Naam van project(zonder spaties, spaties vervangen met - teken)
  • Access Level: Zet GEEN vink bij Public. Wij maken gebruik van robot accounts om de container op te halen
  • Project quota limits: 10 GiB staat standaard ingesteld en hoeft niet veranderd te worden
  • Proxy cache: hoeft niet aangevinkt te worden
  1. Druk op OK. Het project wordt aangemaakt. U ziet een groene balk bovenaan de pagina verschijnen dat het project is aangemaakt.
  2. Aan de rechterkant kunt u een vergrootglas vinden, klik daarop en op het verschenen invoerveld voert u de naam van het aangemaakte project in. Klik op de gewenste projectnaam om het project te openen.

Gebruikers toevoegen/verwijderen

Zorg ervoor dat u bent ingelogd op het register en dat u een project open heeft staan. Doe daarna het volgende:

  1. Klik op Members
  2. Druk op + USER
  3. Bij het geópende venster, voert u het volgende in:
    a. Bij Name: het p-account of s-account
    b. Bij Role: de rol die de gebruiker heeft. Om een container/image te kunnen pushen heeft deze persoon minstens developer rechten nodig.
  4. Druk op OK
  5. De gebruiker kan nu inloggen en een container/image maken

Container/Image pushen

Zodra u een container/image gebouwd heeft moet deze geuploadgeúpload worden naar het register toe. Dit wordt ook wel pushen naar het register toe genoemd.

Op uw lokale computer waar u de container/image heeft gebouwd, doe het volgende:

  1. Open een Command Line Interface(CLI), bijvoorbeeld bash of uitvoeren
  2. Login op het register via docker. Doe dit met het volgende commando: docker login registry.webhosting.rug.nl -u <gebruikersnaam> -p <wachtwoord>
  3. Geef een tag aan uw container/image. Dat gaat via het volgende commando: docker tag <lokale_image_naam>:<lokale_tag> registry.webhosting.rug.nl/<project_naam>/<image_naam>:<tag>

Tip: gebruik als tag de versie nummer en latest. Door latest te gebruiken kunt u automatisch de container/image updaten.

  1. Push de container/image naar het register met het volgende commando: docker push registry.webhosting.rug.nl/<project_naam>/<image_naam>:<tag>
  2. Open een webbrowser, login en controlleer of de container/image in het register staan

GebruikersRobot toevoegen/verwijderenaccount aanmaken

Voor

    het
  • uitlegverkrijgen register
    • van
  • adres
    • de
  • projectopgeslagen aanmaken
    • container/image
  • gebruikersis toevoegen
    • een
  • container opslaan
  • robot account aanmakennodig. Zo maakt u deze aan:

    Voor een Project Robot Account (projectbeheerdersrechten vereist):

    1. Ga met de webbrowser naar https://registry.webhosting.rug.nl en login op Harbor.
  • Ga naar "Projects": Klik in het linker navigatiemenu op "Projects".
  • Selecteer het Project: Klik op de naam van het project waarvoor je een robot account wilt aanmaken.
  • Selecteer "Robot Accounts": Klik in het projectmenu op de tab "Robot Accounts".
  • Nieuw Robot Account: Klik op de knop "+ NEW ROBOT ACCOUNT".
  • Vul de informatie in:
    a. Name: Geef een naam op voor het robot account. Het account krijgt automatisch het prefix robot$ gevolgd door de projectnaam en de door jou gekozen naam (bijvoorbeeld robot$mijn-project+mijn-robot).
    b. Description: (Optioneel) Voeg een beschrijving toe voor het robot account.
    c. Expiration Time: Stel een vervaldatum in voor het token van het robot account of selecteer "Never Expire".
    d. Permissions: Selecteer de rechten die dit robot account binnen dit specifieke project moet hebben (bijvoorbeeld pull images, push images, push and pull Helm charts).
  • Klik op "Save": Klik op de knop "Save" om het robot account aan te maken.
  • Bewaar het Token: Net als bij een systeem robot account, wordt het geheime token na het aanmaken slechts één keer getoond. Kopieer en bewaar het veilig.
    • Back to top