Zum Inhalt springen

Änderungen von Dokument Eigene Autoconf-Rolle erstellen

Zuletzt geändert von Tom Altenbrunn am 2023/03/17 08:03
Von Version 48.4
bearbeitet von Tom Altenbrunn
am 2023/03/16 15:28
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 40.2
bearbeitet von Tom Altenbrunn
am 2023/03/16 10:52
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -8,7 +8,7 @@
8 8  Autoconf liegt wie der Vorgänger Ansible im ctrl-g1 Container und dient dazu, individuelle Einstellungen während des Deployments auf Rechner zu übertragen. Es können über diesen Mechanismus nachträglich auch kleinere Anpassungen an Clients übertragen werden, ohne dafür ein neues Image auf den Server hochzuladen. Somit lassen sich relativ einfach und flexibel diverse Anpassungen an bestehenden Clients vornehmen.
9 9  
10 10  LogoDIDACT ist standardmäßig bereits mit zahlreichen Autoconf-Rollen bestückt, die mitgeliefert werden, um ein möglichst breites Spektrum verschiedenster Anforderungen des allgemeinen Schulbetriebs abzudecken.
11 -Diese fest integrierten Rollen befinden sich im LXC-Container ctrl-g1 im Pfad {{box}}/usr/lib/ld-autoconf/logodidact/roles/{{/box}}.
11 +Diese fest integrierten Rollen befinden sich im LXC-Container ctrl-g1 im Pfad (% data-xwiki-non-generated-content="java.util.List" %)" class="xwiki-metadata-container">/usr/lib/ld-autoconf/logodidact/roles/{{box}}/usr/lib/ld-autoconf/logodidact/roles/{{/box}}(%%).
12 12  
13 13  [[image:image-20230315103418-1.png||height="103" width="1344" class="img-thumbnail"]]
14 14  
... ... @@ -18,7 +18,7 @@
18 18  * bis Puppet-Version **1.4.x** : {{code language="bash"}}/var/lib/ld-autoconf/custom/{{/code}}
19 19  * ab Puppet-Version **1.5.x **:  {{code language="bash" layout="LINENUMBERS"}}/data/ld/autoconf/custom/{{/code}}
20 20  
21 -Der Aufbau einer Autoconf-Rolle unterliegt einer vordefinierten Struktur, bestehend aus einer Beschreibungsdatei {{box}}meta/logodidact.yml{{/box}}(%%), welche die Informationen zu Namen, Beschreibung, Ersteller, Variablen, usw. definiert, sowie zugehörige Skript-Dateien (PowerShell). Diese Skript-Dateien müssen - abhängig vom vorgesehen Ziel-Betriebssystem - in einem Unterordner (% data-xwiki-non-generated-content="java.util.List" %)" class="xwiki-metadata-container"> win/ {{box}} win/ {{/box}}(%%) (//Windows//) oder (% data-xwiki-non-generated-content="java.util.List" %)" class="xwiki-metadata-container"> lin/ {{box}} lin/ {{/box}}(%%) (//Linux//) abgespeichert sein. Zusätzlich besteht auch die Möglichkeit, in einem weiteren Unterordner (% data-xwiki-non-generated-content="java.util.List" %)" class="xwiki-metadata-container"> files/ {{box}} files/ {{/box}}(%%) beliebige Dateien in der Autoconf-Rolle mitzuliefern, wie zum Beispiel Bilder, Videos, etc.
21 +Der Aufbau einer Autoconf-Rolle unterliegt einer vordefinierten Struktur, bestehend aus einer Beschreibungsdatei (% data-xwiki-non-generated-content="java.util.List" %)" class="xwiki-metadata-container">meta/logodidact.yml{{box}}meta/logodidact.yml{{/box}}(%%), welche die Informationen zu Namen, Beschreibung, Ersteller, Variablen, usw. definiert, sowie zugehörige Skript-Dateien (PowerShell). Diese Skript-Dateien müssen - abhängig vom vorgesehen Ziel-Betriebssystem - in einem Unterordner (% data-xwiki-non-generated-content="java.util.List" %)" class="xwiki-metadata-container"> win/ {{box}} win/ {{/box}}(%%) (//Windows//) oder (% data-xwiki-non-generated-content="java.util.List" %)" class="xwiki-metadata-container"> lin/ {{box}} lin/ {{/box}}(%%) (//Linux//) abgespeichert sein. Zusätzlich besteht auch die Möglichkeit, in einem weiteren Unterordner (% data-xwiki-non-generated-content="java.util.List" %)" class="xwiki-metadata-container"> files/ {{box}} files/ {{/box}}(%%) beliebige Dateien in der Autoconf-Rolle mitzuliefern, wie zum Beispiel Bilder, Videos, etc.
22 22  
23 23  __Der strukturelle Aufbau eines AutoConf-Verzeichnisses grafisch dargestellt:__
24 24  
... ... @@ -28,7 +28,7 @@
28 28  
29 29  Für die Funktionalität der Autoconf-Rolle ist es also nötig, PowerShell-Skripte am Server abzuspeichern, die die Instruktionen an den Arbeitsstationen ausführen. Für diese Skripte sind folgende Dateinamen zulässig:
30 30  
31 -* **main.ps1** - Skript wird in allen Phasen ausgeführt, die innerhalb der Beschreibungsdatei (% data-xwiki-non-generated-content="java.util.List" %){{box}}meta/logodidact.yml{{/box}}(%%) festgelegt sind. Eine solche Datei folgt dem Prinzip „in jeder Phase soll genau das gleiche stattfinden“.
31 +* **main.ps1** - Skript wird in allen Phasen ausgeführt, die innerhalb der Beschreibungsdatei (% data-xwiki-non-generated-content="java.util.List" %)" class="xwiki-metadata-container">meta/logodidact.yml{{box}}meta/logodidact.yml{{/box}}(%%) festgelegt sind
32 32  * (% style="color:#8e44ad" %)**setup.ps1**(%%) - Skript wird ausschließlich in der SETUP-Phase während des Deployments ausgeführt. In der Setup-Phase ist der Client noch veränderlich und besitzt noch keine Schutzfunktion, selbst wenn der Schutz aktiviert ist.
33 33  * (% style="color:#8e44ad" %)**custom.ps1**(%%) - Skript wird ausschließlich in der CUSTOM-Phase ausgeführt. Dies geschieht sowohl 1x während des Deployments als auch später nach jedem Hochfahren des PCs 1x im Hintergrund.
34 34  * (% style="color:#8e44ad" %)**user.ps1**(%%) - Skript wird ausschließlich in der USER-Phase ausgeführt. Diese Phase wird nicht direkt während des Deployments durchlaufen, sondern erst später während der Benutzeranmeldung an betriebsbereiten PCs.
... ... @@ -118,7 +118,7 @@
118 118  (% style="color:#8e44ad" %) uuid:(%%) 52318636-c4f5-11ea-baf9-0bff00c66ff4
119 119   visible: true
120 120  (% style="color:#19177c" %) priority:(%%) 0
121 - apply_always: false
121 + applyAlways: false
122 122  (% style="color:#f1c40f" %) tags:(%%)
123 123   - CUSTOM
124 124  (% style="color:#e74c3c" %) vars:(%%)
... ... @@ -291,65 +291,60 @@
291 291  
292 292  ----
293 293  
294 += (% style="font-size:22px" %)__**Weiteres Beispiel: eigene AutoConf-Rolle zur "Deaktivierung der Suchhervorhebung in Windows"**__(%%) =
294 294  
295 -
296 -= (% style="font-size:22px" %)__**Weiteres Beispiel: eigene AutoConf-Rolle zur „Deaktivierung der Suchhervorhebung in Windows“**__(%%) =
297 -
298 298  Im nachfolgenden Beispiel wird eine einfache Rolle zur Deaktivierung der Suchvorhebung in Windows deklariert.
299 299  \\[[image:image-20230316103442-2.png||height="530" width="1142" class="img-thumbnail"]]
300 300  
301 301  ----
302 302  
303 -== (% style="font-size:16px" %)**Aufbau der logodidact.yml**(%%) ==
301 +== (% style="font-size:16px" %)**Aufbau der Logodidact.yml:**(%%) ==
304 304  
305 -Neben den allgemeinen Informationen über die Autoren (authors), Unternehmen (company), einer Beschreibung (description), dem Anzeigenamen (display_name) im LD Control Center, usw, beginnt im Abschnitt {{code language="bash"}}vars{{/code}} die eigentliche Definition der Variable
306 -"**{{code}}disableSearchHighlight{{/code}}**".
303 +Neben den allgemeinen Informationen über die Autoren (authors), Unternehmen (company), einer Beschreibung (description), dem Anzeigenamen (display_name) im LD Control Center, usw, beginnt im Abschnitt {{code language="bash"}}vars{{/code}} die eigentliche Definition der Variable
304 +"**{{code language="bash"}}disableSearchHighlight{{/code}}**".
305 +
307 307  
308 -
309 309  {{code language="yaml" width="45%"}}
310 310  #logodidact.yml
311 311  
312 312  ld_info:
313 313   authors:
314 - - Tom Altenbrunn
315 315   - Olav Krapp
316 316   - Marcel Petersen
317 317   - Kerim Ekin
318 - company: SBE network solutions GmbH
319 - description: | #Beschreibung
320 - Die Suchhervorhebung in der Windows Suchleiste wird deaktiviert
321 - display_name: Windows Suchhervorhebung #Anzeigename im LD Control Center
322 - license: SBE
323 - uuid: fec4ff30-b2a6-407f-a6b3-0a621cd7eaf7 #einmalige UUID
324 - vars: #Deklaration der Variablen
325 - disableSearchHighlight: #Name der Variable
326 - display_name: Suchhervorhebung im Suchfeld deaktivieren #Anzeigename im LD Control Center
327 - optional: true #Auswahl optional
328 - type: BOOLEAN #Variablentyp Boolean = True/False
329 - value: false #Standardwert false
330 - visible: true #Sichtbarkeit der Variable im LD Control Center
331 - priority: 0 #Abarbeitungspriorität
332 - apply_always: false
333 - tags:
315 + company: SBE network solutions GmbH
316 + description: | #Beschreibung
317 + Die Suchhervorhebung in der Windows Suchleiste wird deaktiviert
318 + display_name: Windows Suchhervorhebung #Anzeigename im LD Control Center
319 + license: SBE
320 + uuid: fec4ff30-b2a6-407f-a6b3-0a621cd7eaf7 #einmalige UUID
321 + vars: #Deklaration der Variablen
322 + disableSearchHighlight: #Name der Variable
323 + display_name: Suchhervorhebung im Suchfeld deaktivieren #Anzeigename im LD Control Center
324 + optional: true #Auswahl optional
325 + type: BOOLEAN #Variablentyp Boolean = True/False
326 + value: false #Standardwert false
327 + visible: true #Sichtbarkeit der Variable im LD Control Center
328 + priority: 0 #Abarbeitungspriorität
329 + applyAlways: false #Rolle immer ausführen oder einmalig
330 + tags:
334 334   - CUSTOM #Ausführungszeitpunkt während der/den Phase(n)
335 - systems:
332 + systems:
336 336   - WINDOWS #Betriebssystem
337 337  {{/code}}
338 338  
339 339  ----
340 340  
341 -== (% style="font-size:16px" %)**Aufbau der main.ps1**(%%) ==
338 +== (% style="font-size:16px" %)**Aufbau der main.ps1:**(%%) ==
342 342  
343 -Danach erfolgt die Erstellung des ausführbaren Codes per Powershell. Im ersten Abschnitt (% style="color:#008000" %)**Param** (%%)werden die in der im vorigen Abschnitt definierten Variablen {{code}}vars{{/code}} aus der logodidact.yml aufgeführt und definiert. Bei der Variable "**{{code}}disableSearchHighlight{{/code}}**" handelt es sich um ein Boolean (True/False). Die Bedingung "**[parameter(Mandatory=$false)]**" setzt das Vorhandensein der Variable während dem Ablauf des Skriptes nicht als zwingend notwendig voraus, sodass bei einem darauffolgenden Verarbeitungsfehler o.ä. die Abarbeitung weiter erfolgt.
340 +Danach erfolgt die Erstellung des ausführbaren Codes per Powershell. Im ersten Abschnitt (% style="color:#008000" %)**Param** (%%)werden die in der im vorigen Abschnitt definierten Variaben  {{code language="bash"}}vars{{/code}} aus der logodidact.yml aufgeführt und definiert. Bei der Variable "**{{code}}disableSearchHighlight{{/code}}**" handelt es sich um ein Boolean (True/False). Die Bedingung "**[parameter(Mandatory=$false)]**" setzt das Vorhandensein der Variable während dem Ablauf des Skriptes nicht als zwingend notwendig voraus, sodass bei einem darauffolgenden Verarbeitungsfehler o.ä. die Abarbeitung weiter erfolgt.
341 +\\{{code language="powershell"}}#main.ps1
344 344  
345 -{{code language="powershell"}}
346 -#main.ps1
347 -
348 348  Param
349 349  (
350 350   [parameter(Mandatory=$false)] #Variable zwingend erforderlich?
351 - [bool] #Variablentyp
352 - $disableSearchHighlight #Name der def. Variable aus logodidact.yml
346 + [bool] #Variablentyp
347 + $disableSearchHighlight #Name der def. Variable aus logodidact.yml
353 353  )
354 354  
355 355  $SystemVersion=[System.Environment]::OSVersion.Version #Hole Windows Systemversion
... ... @@ -356,23 +356,22 @@
356 356  
357 357  #Beginn des eigentlichen Codes
358 358  if ($SystemVersion.Major -eq 10 -and $SystemVersion.Build -ge 19044) {
359 - $val = [int]!$disableSearchHighlight
360 - Write-Verbose "Setting EnableDynamicContentInWSB to '$val'"
361 - [Microsoft.Win32.Registry]::SetValue("HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Windows Search","EnableDynamicContentInWSB",$val,[Microsoft.Win32.RegistryValueKind]::DWord)
354 + $val = [int]!$disableSearchHighlight
355 + Write-Verbose "Setting EnableDynamicContentInWSB to '$val'"
356 + [Microsoft.Win32.Registry]::SetValue("HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\Windows Search","EnableDynamicContentInWSB",$val,[Microsoft.Win32.RegistryValueKind]::DWord)
362 362  } else {
363 - Write-Host "Feature ist erst ab dem Release 21H2 verfügbar."
364 -}
365 -{{/code}}
358 + Write-Host "Feature ist erst ab dem Release 21H2 verfügbar."
359 +}{{/code}}
366 366  
367 367  ----
368 368  
369 -== (% style="font-size:16px" %)**Einlesen der AutoConf-Rollen am Server**(%%) ==
363 +== (% style="font-size:16px" %)**Einlesen der AutoConf-Rollen am Server:**(%%) ==
370 370  
371 -[[image:image-20230316110425-1.png||height="124" width="1186" class="img-thumbnail"]]
365 +[[image:image-20230316103224-1.png||height="128" width="1226" class="img-thumbnail"]]
372 372  
367 +----
373 373  
374 -== (% style="font-size:16px" %)**Ansicht im LD Control Center**(%%) ==
369 +== (% style="font-size:16px" %)**Ansicht im LD Control Center:**(%%) ==
375 375  
376 -[[image:image-20230316110525-2.png||class="img-thumbnail"]]
377 -
378 -
371 +(% class="wikigeneratedid" %)
372 + [[image:image-20230316095106-2.png||class="img-thumbnail"]]
image-20230316110425-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.TomAltenbrunn@sbede
Größe
... ... @@ -1,1 +1,0 @@
1 -166.3 KB
Inhalt
image-20230316110525-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.TomAltenbrunn@sbede
Größe
... ... @@ -1,1 +1,0 @@
1 -48.3 KB
Inhalt