Gatewaypakete über Container ausführen

Ein Gateway, welche auf dem OCT Python Framework basiert, kann ohne Anpassungen über einen Container auf Azure ausgeführt werden. Diese Anleitung beschreibt den Ablauf der Einrichtung

1. das Gateway Release in einem Storage Account ablegen

• Storage Account anlegen mit AccessKey

• Dateifreigabe (File Share) anlegen (könnte beliebiger Name sein, sollte aber der Konvention des jeweiligen Gateways entsprechen)

  • am besten im Azure Storage Explorer, Details und Anleitung siehe Blob Storages für Datenuploads | Verwendung des Azure Storage Explorer

• Ordner “scripts” in der Dateifreigabe anlegen

• Gateway Release im Ordner “scripts” ablegen

• config Datei passend ausfüllen, i.d.R

  • Winauth immer 0

  • SQL Benutzer für Quell / Zieldatenbank

  • API Benutzer

• Storage Account als Datenquelle in OCT registrieren und Name der Dateifreigabe angeben

2. eine Pipeline mit Step Containerausführung anlegen

• Ressourengruppenname: rgp_customercontainer

• Containerregistrierung: octcontainer.azurecr.io

• Imagename: oct-python:v1

• Containergruppename: [Kundennummer]gruppe - z.B. ad01234gruppe

• Containername: [Kundennummer]zweck - z.B. ad01234personal

• Anzahl Prozessoren: 1, mehr nur falls nötig

• Anzahl RAM: 1, mehr nur falls nötig

• Authentifizierung: umi-container

• Storage:

  • Auswählen aus Datenquellen

  • Volumname: Name der Dateifreigabe

  • Dateifreigabename: Name der Dateifreigabe

• Netzwerkeinstellungen leer lassen (wir nur in Sonderfällen von Saxess configuriert)

• Startbefehl:

  • dieser ist spezifisch pro Gateway und dort dokumentiert

  • bei Gateways ohne Parameterübergabe meist “python,run.py,--ScriptName=main.py”

  • bei Gateways mit Parameterübergabe meist “python,run.py,--ScriptName=main.py,--ScriptArguments=--modus=1 --configfile=config1.json”

  • bei Ordnerstruktur unter “scripts” mit Pfad “python,run.py,--ScriptName=Gateway_DATEV.connect/main.py,--ScriptArguments=--modus=1 --configfile=config1.json”

Zusatzinformationen

Pfadangaben in der config Datei

• lokal (unter Windows) schreibt man in der config Pfadangaben mit zwei Backslash

}
  "quell_ordner": "D:\\Daten",
  "ziel_ordner": "D:\\Export"
}

• bei der Ausführung im Container sind alle Pfad nach Linux Konvention mit einem Slash zu schreiben

{
  "quell_ordner": "/mnt/data",
  "ziel_ordner": "/mnt/export"
}

Weiterführenden Informationen

Beschreibung der Containerfunktionen im OCT Handbuch

OCT Containerkatalog (nur saxess intern verfügbar)