Änderungen von Dokument Eigene Autoconf-Rolle erstellen

Zuletzt geändert von Tom Altenbrunn am 2023/03/17 08:03

Von 22.1 nach 21.1 Von 29.1 nach 28.1

Von Version 28.1

bearbeitet von Jonas Mayer
am 2023/03/16 07:55

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Auf Version 22.1

bearbeitet von Jonas Mayer
am 2023/03/15 21:31

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Inhalt

@@ -1,8 +1,6 @@
  {{toc depth="3"/}}
------
--
  = (% style="font-size:22px" %)__**Allgemeines**__(%%) =
@@ -41,9 +41,9 @@
  (% style="font-size:12px" %)**Hinweis: **Skripte, die durch ihren Dateinamen auf einzelne Phasen eingeschränkt sind ((% style="color:#8e44ad; font-size:12px" %)lila eingefärbt(% style="font-size:12px" %)), dürfen sich inhaltlich zueinander unterscheiden. Dadurch kann eine Autoconf-Rolle sehr flexibel gestaltet werden und in den verschiedenen Phasen des Deployments unterschiedliche Aktionen ausführen.
  )))
++
  ----
--
  = (% style="font-size:22px" %)__**Beispielaufbau einer logodidact.yml**__(%%) =
@@ -74,9 +74,9 @@
  **Tipp:** Der Variablentyp ENUM aus dem Beispiel ergibt ein Dropdown-Menü, in dem man aus den vordefinierten 4 Werten (none / compact / detailed / verbose) auswählen kann.
  )))
++
  ----
--
  = (% style="font-size:22px" %)__**Neue AutoConf-Rollen nach Fertigstellung freigeben**__(%%) =
@@ -93,9 +93,9 @@
  [[image:attach:autoconf.png||data-xwiki-image-style-border="true" class="img-thumbnail"]]
++
  ----
--
  = (% style="font-size:22px" %)__**Weiteres, funktionsfertiges Beispiel: Rolle „WLAN Profil mit PSK anlegen“**__(%%) =
@@ -106,7 +106,7 @@
  root@ctrl-g1:~~ # cat /usr/lib/ld-autoconf/logodidact/roles/ld_wlan_psk/meta/logodidact.yml
  )))
--== (% style="font-size:16px" %)**Struktureller Aufbau der logodidact.yml**(%%) ==
++== (% style="font-size:16px" %)** Struktureller Aufbau der logodidact.yml**(%%) ==
  (% class="box" %)
  (((
@@ -114,13 +114,13 @@
    authors:
      - Marcel Petersen
    company: SBE network solutions GmbH
--(% style="color:#1abc9c" %)  display_name:(%%) WLAN Profil mit PSK anlegen
++(% style="color:#1abc9c" %)display_name:(%%) WLAN Profil mit PSK anlegen
    license: SBE
--(% style="color:#8e44ad" %)  uuid:(%%) 52318636-c4f5-11ea-baf9-0bff00c66ff4
++(% style="color:#8e44ad" %) uuid:(%%) 52318636-c4f5-11ea-baf9-0bff00c66ff4
    visible: true
--(% style="color:#19177c" %)  priority:(%%) 0
++  priority: 0
    applyAlways: false
--(% style="color:#f1c40f" %)  tags:(%%)
++(% style="color:#f1c40f" %) tags:(%%)
      - CUSTOM
  (% style="color:#e74c3c" %)  vars:(%%)
      ssid:
@@ -131,7 +131,7 @@
        display_name: Passwort
        optional: false
        type: PASSWORD
--(% style="color:#2980b9" %)  systems:(%%)
++(% style="color:#2980b9" %)systems:(%%)
      - WINDOWS
      - LINUX
  )))
@@ -140,8 +140,6 @@
  (% style="color:#8e44ad" %)**uuid**(%%) = ID der Autoconf-Regel. Muss einmalig sein. Bei einer eigenen Autoconf-Rolle sollte der Wert am besten neu generiert werden. [[https:~~/~~/www.uuidgenerator.net/>>url:https://www.uuidgenerator.net/]]
--(% style="color:#19177c" %)**priority**(% style="color:#2980b9" %)** **(%%)= Legt die Verarbeitungsreihenfolge der Autoconf-Rolle gegenüber weiteren Rollen fest, die in derselben Phase ausgeführt werden. Bei gleicher Priorität findet die Abarbeitung alphabetisch statt. Eine höhere Priorität führt zu früherer Ausführung.
--
  (% style="color:#f1c40f" %)**tags**(%%) = beschreibt, in welchen Phasen die Autoconf-Regel ausgeführt wird.
  (% style="color:#e74c3c" %)**vars**(%%)** **= definiert mögliche Variablen, die den Skripten übergeben werden
@@ -151,24 +151,19 @@
  *  type = bestimmt den Typ der Variable. Gültige Typen sind: STRING, PASSWORD, BOOLEAN, ENUM, ARRAY, INTEGER
  *  example = Zeigt einen grau eingefärbten Beispieltext innerhalb der definierten Variable an, ohne dass dieser als Wert festgelegt ist (Hilfsmittel für Anwender).
--(% style="color:#2980b9" %)**systems **(%%)= Legt fest, welche Betriebssystem-Typen durch die Autoconf-Rolle unterstützt werden. Gültige Systeme sind WINDOWS / LINUX. Die Rolle aus dem Beispiel unterstützt beide Betriebssysteme gleichzeitig.
++(% style="color:#2980b9" %) **systems **(%%)= Legt fest, welche Betriebssystem-Typen durch die Autoconf-Rolle unterstützt werden. Gültige Systeme sind WINDOWS / LINUX. Die Rolle aus dem Beispiel unterstützt beide Betriebssysteme gleichzeitig.
++
  ----
++== (% style="font-size:16px" %)**Inhalt des PowerShell-Skripts main.ps1, das die Variablen als Parameter entgegennimmt und verwendet**(%%) ==
--== (% style="font-size:16px" %)**Inhalt des PowerShell-Skripts main.ps1, das die Variablen entgegennimmt**(%%) ==
--Im Unterverzeichnis {{box}} win/ {{/box}} oder {{box}} lin/ {{/box}} der Autoconf-Rolle können sich wie erläutert unterschiedliche PowerShell-Skripte zur Ausführung in den verschiedenen Phasen befinden.
--In dieser Rolle liegt konkret das allgemeingültige Skript {{box}}main.ps1{{/box}} vor, welches die Variablen als Parameter ##$ssid## und ##$psk## intern verwendet.
++Im Verzeichnis {{box}} win/ {{/box}} können sich unterschiedliche Powershell-Skripte befinden. In dieser Rolle liegt das allgemeingültige Skript main.ps1 vor, welches die Parameter ##$ssid## und ##$psk## intern verwendet.
--
--(% style="color:#19177c" %)**Windows Variante**
--
--{{code language="text" width="50%"}}
++{{code width="50%"}}
  root@ctrl-g1:~ # cat /usr/lib/ld-autoconf/logodidact/roles/ld_wlan_psk/win/main.ps1
--{{/code}}
--{{code width="50%" language="powershell"}}
  Param
  (
   [parameter(Mandatory=$false)]
@@ -221,71 +221,22 @@
    Remove-Item -Path $file -Force
  }
--{{/code}}
--
--(% style="color:#19177c" %)**Linux Variante (Network Manager)**
--
--{{code width="50%" language="text"}}
--root@ctrl-g1:~ # cat /usr/lib/ld-autoconf/logodidact/roles/ld_wlan_psk/win/main.ps1
++Param() = hier werden die übergebenen Parameter von meta/logodidact.yml zu lokalen Variablen.
  {{/code}}
--{{code language="powershell" width="50%"}}
--Param
--(
--  [parameter(Mandatory=$false)]
--  [String]
--  $ssid,
--  [parameter(Mandatory=$false)]
--  [String]
--  $psk
--)
++====  ====
--if ($ssid -ne '' -and $psk -ne '') {
--  if (Get-Command "nmcli" -ErrorAction SilentlyContinue) {
--    # Check if kernel modules are up
--    nmcli dev wifi rescan
-- if ($LASTEXITCODE -ne 0) {
--   Start-Sleep -Seconds 30
-- }
--
-- # Check again
-- nmcli dev wifi rescan
-- if ($LASTEXITCODE -ne 0) {
--   Write-Verbose "Skipping role. There might be no WiFi device installed."
--   exit 0
-- }
--
--    $config = "/etc/NetworkManager/system-connections/$ssid"
++====  ====
--    if (Test-Path -Path $config) {
--      Write-Verbose "Removing '$config'"
--      Remove-Item -Path $config -Recurse -Force
--    }
++====  ====
--    Write-Verbose "Connecting to '$ssid'"
--
--    nmcli device wifi connect """$ssid""" password """$psk"""
--
--    if ($LASTEXITCODE -eq 0) {
--      Start-Sleep -Seconds 5
--      nmcli con up """$ssid"""
++====  ====
--      if ($LASTEXITCODE -ne 0) {
--        Write-Verbose "Error: Credentials wrong?"
++====  ====
--        if (Test-Path -Path $config) {
--          Write-Verbose "Removing '$config'"
--          Remove-Item -Path $config -Recurse -Force
--        }
--      }
--    }
--
--    Write-Verbose "Exiting with code: $LASTEXITCODE"
--    exit $LASTEXITCODE
--  }
++====  ====
--  Write-Verbose "No suitable implementation found"
--  exit 1
--}
--{{/code}}
++====  ====
++
++====  ====