Docker
------

Beschreibung
^^^^^^^^^^^^

Installation Docker Runtime
^^^^^^^^^^^^^^^^^^^^^^^^^^^

RaspberryPi VoipioOS
,,,,,,,,,,,,,,,,,,,,

Liefert bereits einen laufenden Docker Host, keine weitere Installation nötig.

Ubuntu Server Linux x64/amd64
,,,,,,,,,,,,,,,,,,,,,,,,,,,,,

Ubuntu Image: http://mirror.serverloft.eu/ubuntu/releases/18.04.1/ubuntu-18.04.1-live-server-amd64.iso
Docker Installation: https://docs.docker.com/install/linux/docker-ce/ubuntu/

Paketquellen einlesen::

    sudo apt-get update 

Abhängigkeiten installieren::

    sudo apt-get install -y apt-transport-https ca-certificates \
     curl gnupg-agent software-properties-common

APT Repokey importieren::

    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

Repository hinzufügen::

    sudo add-apt-repository \
     "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

Quellen neu einlesen::

    sudo apt-get update 

und Docker installieren::

    sudo apt-get install -y docker-ce docker-ce-cli containerd.io git python python-pip

Docker Compose installieren::

    sudo pip install docker-compose pip --upgrade


Registry Login
^^^^^^^^^^^^^^

Die von trizwo in der ``Registry`` bereit gestellten ``Images`` sind in ``Repositories`` aufgeteilt, die ihnen nach einem erfolgreichen Login zu Verfügung stehen.
Die Zugangsdaten bestehend aus ``Username`` und ``Password`` wurde ihnen mitgeteilt.
Mit den Zugangsdaten können Sie den Docker Host an der trizwo Registry anmelden::

    docker login reg.cloud.trizwo.it
    Username: <ihr Username>
    Password: <ihr Password>
    Login Succeeded

Erfolgreich abgeschlossen wurde die Anmeldung, wenn ``Login Succeeded`` ausgegeben wird.

        
Bezug der Images
^^^^^^^^^^^^^^^^

Zum Start der Container werden die Images aus der trizwo Registry auf dem lokalem Host benötigt.
``docker-compose`` kann über den Domainteil der Container Namen (``reg.cloud.trizwo.it``) die entsprechende Registry bzw. dort in den verschiedenen Repositories die benötigten Container finden. Mit dem Befehl ``pull`` wird das benötigte Image herunter geladen::

    docker-compose pull

Container starten
^^^^^^^^^^^^^^^^^

Das benötigte Image ist nun lokal vorhanden und somit steht einem Start nichts mehr im Wege. Wir starten den HDM im Hintergrund::

    docker-compose up -d --build


den erfolgreichen Start können wir kontrollieren mit::

    docker ps| grep hdm
    37c58ac7e381        reg.cloud.trizwo.it/hdm/hotdeskingmanager:latest   "/bin/sh -c /hdm/c..."   35 seconds ago      Up 34 seconds       0.0.0.0:1700->80/tcp    hotdeskingmanager_master_1

es wurde im Installationsordner ein Unterordner erstellt mit den persistenten Containerdaten::

    ls -lahR ./data

wenn dann alles funktioniert hat ist die Installation beendet und der HDM sollte auf ``http://*dockerhost_or_ip*:1700/hotdesking/`` erreichbar sein. Username und Password lauten dort ``admin`` und ``hotdesking``.

in dem Ordner ``./data/cloudmaster/hotdesking/`` sollte sich dann auch bereits das Logfile zu finden sein. Die Ausgaben einer jeweiligen Instanz lassen sich auch über Docker direkt anzeigen::

    docker logs -f hotdeskingmanager_hdm_1

Updates
^^^^^^^

.. note::

    Zum Bezug von offlineupdates ohne Internet Zugriff bitte wie unter "Offline Bezug des Image" verfahren.

In der ``docker-compose.yml`` ist das zu benutzende Image definiert. Daher laden wir eine evtl. neuere Version des Images aus der Registry herunter::

     docker-compose pull

und starten unsere Container mit den nun aktualisierten Containern neu::

     docker-compose up -d --build


Verwendung eines HTTP Proxy für ausgehende Verbindungen
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Für ``ausgehende`` HTTP Verbindungen der Container kann in der Konfiguration des Docker Host ein HTTP Proxy definiert werden. Diese Einstellungen werden anschließend für neue Container verwendet. Die entsprechende Konfigurationsdatei ``/root/.docker/config.json`` muss um folgende Angaben erweitert werden::

    {
      "proxies": {
        "default": {
          "httpProxy": "http://127.0.0.1:3001",
          "httpsProxy": "https://127.0.0.1:3002",
          "noProxy": "*.test.example.com,.example2.com"
        }
      }
    }

Zur Übernahme der Änderung muss der Docker Daemon neu gestartet werden.