WALinuxAgent-Download – Download des WALinuxAgent-Quellcodes

WALinuxAgent

Anderer Quellcode

2.11.1.12

Herunterladen

Microsoft Azure Linux-Agent

Der Herausgeber von Downcodes stellt Ihnen den Microsoft Azure Linux Agent (waagent) vor, ein Tool, das die Linux-Bereitstellung und die Interaktion virtueller Maschinen mit Azure Fabric Controller verwaltet. Es bietet die folgenden Funktionen für Linux-IaaS-Bereitstellungen:

Funktion

1. Image-Bereitstellung: waagent ist für die Verwaltung des anfänglichen Bereitstellungsprozesses von virtuellen Linux-Maschinen verantwortlich, einschließlich der Konfiguration des Netzwerks, der Installation von Treibern und der Einrichtung erster Benutzerkonten.

2. Netzwerkverwaltung: Der Waagent koordiniert sich mit dem Azure Fabric Controller, um die Netzwerkeinstellungen der virtuellen Maschine zu konfigurieren, wie z. B. IP-Adresse, Subnetzmaske und Gateway.

3. Kernel-Verwaltung: waagent kann die Kernel-Updates der virtuellen Maschine verwalten, um sicherzustellen, dass immer die neueste und sichere Kernel-Version ausgeführt wird.

4. Diagnose: waagent kann Informationen zum Zustand virtueller Maschinen sammeln und melden, um bei der Diagnose von Problemen und der Behebung von Fehlern zu helfen.

5. SCVMM-Bereitstellung: waagent unterstützt die Integration mit System Center Virtual Machine Manager (SCVMM) zur Verwaltung und Bereitstellung virtueller Maschinen.

6. Erweiterungen für virtuelle Maschinen: waagent unterstützt die Ausführung von Erweiterungen für virtuelle Maschinen, die zusätzliche Funktionen und Anpassungen bieten, z. B. die Installation von Software oder die Überwachung von Metriken.

7. Kommunikation: waagent kommuniziert mit Azure Fabric Controller über zwei Kanäle:

* Boot-Time-Append-DVD: Für IaaS-Bereitstellungen stellt eine Boot-Time-Append-DVD mit einer OVF-kompatiblen Konfigurationsdatei Bereitstellungsinformationen bereit (zusätzlich zum SSH-Schlüsselpaar).

* REST-API: Ein TCP-Endpunkt, der eine REST-API zum Abrufen von Bereitstellungs- und Topologiekonfigurationen bereitstellt.

HTTP-Proxy

waagent kann einen HTTP-Proxy über die Umgebungsvariablen httpproxy (für HTTP-Anfragen) oder httpsproxy (für HTTPS-Anfragen) verwenden. Aufgrund von Python-Einschränkungen unterstützt waagent keine HTTP-Proxys, die eine Authentifizierung erfordern.

Wenn die Umgebungsvariable no_proxy festgelegt ist, umgeht waagent ebenfalls den Proxy.

Beachten Sie, dass die Art und Weise, wie diese Umgebungsvariablen für den waagent-Dienst definiert werden, je nach Distribution unterschiedlich ist. Bei Distributionen, die systemd verwenden, besteht ein gängiger Ansatz darin, „Environment“ oder „EnvironmentFile“ im Abschnitt „[Service]“ der Dienstdefinition zu verwenden, beispielsweise durch eine Überschreibung oder das Einfügen einer Datei (siehe systemctl edit für Überschreibungen).

Beispiel

`

cat /etc/systemd/system/walinuxagent.service.d/http-proxy.conf

[Service]

Environment="http_proxy=http://proxy.example.com:80/"

Environment="https_proxy=http://proxy.example.com:80/"

#

`

waagent übergibt seine Umgebung an die von ihm ausgeführten Erweiterungen der virtuellen Maschine, einschließlich httpproxy und httpsproxy. Wenn Sie also einen Proxy für waagent definieren, wird auch ein Proxy für die Erweiterung der virtuellen Maschine definiert.

Wenn Sie die Konfigurationsvariablen HttpProxy.Host und HttpProxy.Port verwenden, überschreiben diese die Umgebungseinstellungen. Beachten Sie, dass diese Konfigurationsvariablen lokal für den Waagent-Prozess sind und nicht an die Erweiterung der virtuellen Maschine übergeben werden.

brauchen

waagent benötigt einige Systempakete, um ordnungsgemäß zu funktionieren. Diese Pakete variieren je nach Distribution.

Installieren

Die Installation über das Distributionspaket-Repository ist die einzige unterstützte Installationsmethode.

Für erweiterte Optionen können Sie die Installation von der Quelle durchführen, z. B. die Installation an einem benutzerdefinierten Speicherort oder die Erstellung eines benutzerdefinierten Images. Die Installation von der Quelle überschreibt jedoch möglicherweise die von Ihrer Distribution an waagent vorgenommenen Anpassungen und ist nur für fortgeschrittene Benutzer gedacht. Wir haben nur sehr begrenzte Unterstützung für diese Methode.

Um von der Quelle zu installieren, können Sie setuptools verwenden:

`

sudo python setup.py install --register-service

`

Verwenden Sie für Python 3:

`

sudo python3 setup.py install --register-service

`

Sie können weitere Installationsoptionen anzeigen, indem Sie den folgenden Befehl ausführen:

`

sudo python setup.py install --help

`

Die waagent-Protokolldatei wird in /var/log/waagent.log gespeichert.

Schließlich können Sie Ihr eigenes RPM- oder DEB-Paket mithilfe der Konfigurationsbeispiele anpassen, die in den Abschnitten DEB und RPM unten bereitgestellt werden. Diese Methode ist auch für fortgeschrittene Benutzer geeignet und wir haben nur sehr begrenzte Unterstützung für diese Methode.

Upgrade

Das Upgrade über das Distributionspaket-Repository oder die Verwendung automatischer Updates sind die einzigen unterstützten Methoden. Weitere Informationen finden Sie hier: Linux-Agent aktualisieren.

Um waagent vom Quellcode zu aktualisieren, können Sie setuptools verwenden. Ein Upgrade von der Quelle ist nur für fortgeschrittene Benutzer möglich und wir unterstützen diese Methode nur sehr begrenzt.

`

sudo python setup.py install --force

`

Starten Sie den Waagent-Dienst neu:

`

sudo service waagent neu starten

`

Verwenden Sie für Ubuntu:

`

Sudo-Dienst walinuxagent neu starten

`

Verwenden Sie für CoreOS:

`

sudo systemctl restart waagent

`

Befehlszeilenoptionen

Logo

-verbose: Erhöhen Sie die Ausführlichkeit des angegebenen Befehls.

-force: Interaktive Bestätigung für einige Befehle überspringen.

Befehl

-help: Unterstützte Befehle und Flags auflisten.

-deprovision: Versucht, das System zu bereinigen und es für die erneute Bereitstellung geeignet zu machen, indem Folgendes entfernt wird:

* Alle SSH-Hostschlüssel (wenn Provisioning.RegenerateSshHostKeyPair in der Konfigurationsdatei „y“ ist).

* Nameserver-Konfiguration in /etc/resolv.conf.

* Das Root-Passwort in /etc/shadow (wenn Provisioning.DeleteRootPassword in der Konfigurationsdatei „y“ lautet).

* Zwischengespeicherte DHCP-Client-Lease.

* Hostnamen auf localhost.localdomain zurücksetzen.

warnen! Deprovision kann nicht garantieren, dass das Bild von allen sensiblen Informationen bereinigt wurde und für die Weiterverbreitung geeignet ist.

-deprovision+user: Führt alle Aktionen im Rahmen der Deprovisionierung aus (oben beschrieben) und löscht außerdem das zuletzt bereitgestellte Benutzerkonto und die zugehörigen Daten.

-version: Zeigt die waagent-Version an.

-serialconsole: Konfigurieren Sie GRUB so, dass ttyS0 (der erste serielle Port) als Startkonsole markiert wird. Dadurch wird sichergestellt, dass Kernel-Boot-Protokolle an den seriellen Port gesendet werden und zum Debuggen verwendet werden können.

-daemon: Führen Sie waagent als Daemon-Prozess aus, um die Interaktion mit der Plattform zu verwalten. Dieser Parameter wird im waagent-Initialisierungsskript für waagent angegeben.

-start: waagent als Hintergrundprozess ausführen.

-collect-logs [-full]: Führt das Dienstprogramm zur Protokollsammlung aus, das agentenbezogene Protokolle zu Debugging-Zwecken sammelt und sie im Agentenordner auf der Festplatte speichert. Der genaue Standort wird beim Ausführen angezeigt. Verwenden Sie das Flag -full für eine umfassendere Protokollerfassung.

Konfiguration

Eine Konfigurationsdatei (/etc/waagent.conf) steuert den Betrieb von waagent. Leere Zeilen und Zeilen, deren erstes Zeichen # ist, werden ignoriert (Zeilenendekommentare werden nicht unterstützt).

Eine Beispielkonfigurationsdatei ist unten dargestellt:

`

Extensions.Enabled=y

Extensions.GoalStatePeriod=6

Provisioning.Agent=auto

Provisioning.DeleteRootPassword=n

Provisioning.RegenerateSshHostKeyPair=y

Provisioning.SshHostKeyPairType=rsa

Provisioning.MonitorHostName=y

Provisioning.DecodeCustomData=n

Provisioning.ExecuteCustomData=n

Provisioning.PasswordCryptId=6

Provisioning.PasswordCryptSaltLength=10

ResourceDisk.Format=y

ResourceDisk.Filesystem=ext4

ResourceDisk.MountPoint=/mnt/resource

ResourceDisk.MountOptions=Keine

ResourceDisk.EnableSwap=n

ResourceDisk.EnableSwapEncryption=n

ResourceDisk.SwapSizeMB=0

Logs.Verbose=n

Logs.Collect=y

Logs.CollectPeriod=3600

OS.AllowHTTP=n

OS.RootDeviceScsiTimeout=300

OS.EnableFIPS=n

OS.OpensslPath=Keine

OS.SshClientAliveInterval=180

OS.SshDir=/etc/ssh

HttpProxy.Host=Keine

HttpProxy.Port=Keine

`

Im Folgenden werden die verschiedenen Konfigurationsmöglichkeiten im Detail beschrieben. Konfigurationsoptionen sind in drei Typen unterteilt: Boolescher Wert, Zeichenfolge und Ganzzahl. Boolesche Konfigurationsoptionen können als „y“ oder „n“ angegeben werden. Das spezielle Schlüsselwort „None“ kann mit bestimmten String-Konfigurationselementen verwendet werden, wie unten beschrieben.

Profiloptionen

Erweiterungen.Aktiviert

Typ: Boolesch

Standardwert: y

Mit dieser Option kann der Benutzer erweiterte Verarbeitungsfunktionen im Agent aktivieren oder deaktivieren. Gültige Werte sind „y“ oder „n“. Wenn die erweiterte Verarbeitung deaktiviert ist, wird der Zielstatus weiterhin verarbeitet und der Status der virtuellen Maschine wird weiterhin gemeldet, jedoch nur alle 5 Minuten. Die erweiterte Konfiguration im Zielzustand wird ignoriert. Beachten Sie, dass Funktionen wie das Zurücksetzen von Passwörtern, Aktualisierungen von SSH-Schlüsseln und Sicherungen auf Erweiterungen angewiesen sind. Deaktivieren Sie diese Option nur, wenn Sie die Erweiterung überhaupt nicht benötigen.

Hinweis: Das Deaktivieren der Erweiterung auf diese Weise ist nicht dasselbe, als würde man den Proxy überhaupt nicht verwenden. Dazu muss das ProvisionVMAgent-Flag zum Zeitpunkt der Bereitstellung über die verwendete API gesetzt werden. Weitere Einzelheiten dazu werden wir in unserem Wiki veröffentlichen, es ist jedoch noch nicht verfügbar.

Extensions.WaitForCloudInit

Typ: Boolesch

Standardwert: n

Warten Sie, bis Cloud-Init abgeschlossen ist, bevor Sie die Erweiterung der virtuellen Maschine durchführen (Cloud-Init-Status --wait).

Cloud-Init- und Virtual-Machine-Erweiterungen sind gängige Methoden zum Anpassen einer virtuellen Maschine während der Erstbereitstellung. Standardmäßig beginnt der Agent mit der Ausführung der Skalierung, während sich cloud-init möglicherweise noch in der „Konfigurations“-Phase befindet, und wartet nicht auf den Abschluss der „letzten“ Phase. cloud-init und extensions können Vorgänge ausführen, die miteinander in Konflikt stehen (z. B. versuchen beide möglicherweise, ein Paket zu installieren). Wenn Sie diese Option auf „y“ setzen, wird sichergestellt, dass die Erweiterung der virtuellen Maschine erst durchgeführt wird, nachdem cloud-init alle Phasen abgeschlossen hat.

Beachten Sie, dass für die Verwendung dieser Option ein benutzerdefiniertes Image erstellt und der Wert dieser Option auf „y“ gesetzt werden muss, um sicherzustellen, dass der Wartevorgang während der ersten Bereitstellung der virtuellen Maschine ausgeführt wird.

Extensions.WaitForCloudInitTimeout

Typ: Ganzzahl

Standardwert: 3600

Zeitüberschreitung in Sekunden, während der der Agent auf Cloud-Init wartet. Wenn die Zeitüberschreitung abläuft, führt der Agent weiterhin die Erweiterung der virtuellen Maschine durch. Weitere Informationen finden Sie unter Extensions.WaitForCloudInit.

Extensions.GoalStatePeriod

Typ: Ganzzahl

Standardwert: 6

Wie oft (in Sekunden) der neue Zielstatus abgefragt und der Status virtueller Maschinen und Erweiterungen gemeldet werden soll. Der Zielzustand beschreibt den gewünschten Zustand der Erweiterung auf der virtuellen Maschine.

Hinweis: Das Festlegen dieses Parameters für mehr als ein paar Minuten kann dazu führen, dass der Status der virtuellen Maschine im Azure-Portal als „Nicht reagiert/Nicht verfügbar“ gemeldet wird. Darüber hinaus beeinflusst diese Einstellung, wie schnell der Agent mit der Skalierung beginnt.

AutoUpdate.UpdateToLatestVersion

Typ: Boolesch

Standardwert: y

Ermöglicht die automatische Aktualisierung von Erweiterungshandlern. Erweiterungshandler sind für die Verwaltung von Erweiterungen und die Meldung des Status der virtuellen Maschine verantwortlich. Die Kernfunktionalität des Agenten ist im Erweiterungshandler enthalten, und Benutzern wird empfohlen, diese Option zu aktivieren, um die neueste Version beizubehalten.

Wenn diese Option aktiviert ist, installiert der Agent neue Versionen, sobald diese verfügbar sind. Wenn die Option deaktiviert ist, installiert der Agent keine neuen Versionen, sondern verwendet die neueste Version, die bereits auf der virtuellen Maschine installiert ist.

veranschaulichen:

Weitere Informationen zu Agent-Versionen finden Sie in unseren FAQ.

Weitere Informationen zu Agent-Updates finden Sie in unseren FAQ.

Weitere Informationen zu AutoUpdate.UpdateToLatestVersion und AutoUpdate.Enabled finden Sie in unseren FAQ.

AutoUpdate.Enabled

Typ: Boolesch

Standardwert: y

Ermöglicht die automatische Aktualisierung von Erweiterungshandlern. Dieses Flag wird aus Legacy-Gründen unterstützt und wir empfehlen dringend, anstelle dieses Flags AutoUpdate.UpdateToLatestVersion zu verwenden.

Der Unterschied zwischen diesen beiden Flags besteht darin, dass AutoUpdate.Enabled bei Einstellung auf „n“ die auf dem Image vorinstallierte Version des Erweiterungshandlers verwendet, während AutoUpdate.UpdateToLatestVersion die neueste auf der virtuellen Maschine installierte Version verwendet (über automatische Updates). .

In den meisten Distributionen ist der Standardwert „y“.

Provisioning.Agent

Typ: Zeichenfolge

Standardwert: automatisch

Wählen Sie den zu verwendenden Bereitstellungsagenten aus (oder lassen Sie waagent dies bestimmen, indem Sie „auto“ angeben). Mögliche Optionen sind „auto“ (Standard), „waagent“, „cloud-init“ oder „disabled“.

Provisioning.Enabled (entfernt in 2.2.45)

Typ: Boolesch

Standardwert: y

Mit dieser Option kann der Benutzer die Bereitstellungsfunktion im Agent aktivieren oder deaktivieren. Gültige Werte sind „y“ oder „n“. Wenn die Bereitstellung deaktiviert ist, bleiben die SSH-Host- und Benutzerschlüssel im Image erhalten und alle in der Azure-Bereitstellungs-API angegebenen Konfigurationen werden ignoriert.

HINWEIS: Diese Konfigurationsoption wurde entfernt und hat keine Wirkung mehr. waagent erkennt cloud-init jetzt automatisch als Bereitstellungsagent (optional überschrieben mit Provisioning.Agent).

Provisioning.MonitorHostName

Typ: Boolesch

Standardwert: n

Überwachen Sie Hostnamenänderungen und veröffentlichen Sie Änderungen über DHCP-Anfragen.

Provisioning.MonitorHostNamePeriod

Typ: Ganzzahl

Standardwert: 30

Wie oft (in Sekunden) Hostnamenänderungen überwacht werden sollen. Wenn MonitorHostName nicht festgelegt ist, wird diese Einstellung ignoriert.

Provisioning.UseCloudInit

Typ: Boolesch

Standardwert: n

Diese Option aktiviert/deaktiviert die Unterstützung für die Bereitstellung über Cloud-Init.

Bei „true“ („y“) wartet der Agent auf den Abschluss von cloud-init, bevor er Erweiterungen installiert und den neuesten Zielstatus verarbeitet. Provisioning.Enabled muss deaktiviert sein („n“), damit diese Option wirksam wird. Wenn Sie „Provisioning.Enabled“ auf „true“ („y“) setzen, wird diese Option außer Kraft gesetzt und der integrierte Agent-Bereitstellungscode ausgeführt.

HINWEIS: Diese Konfigurationsoption wurde entfernt und hat keine Wirkung mehr. waagent erkennt cloud-init jetzt automatisch als Bereitstellungsagent (optional überschrieben mit Provisioning.Agent).

Provisioning.DeleteRootPassword

Typ: Boolesch

Standardwert: n

Wenn diese Option gesetzt ist, wird das Root-Passwort in der Datei /etc/shadow während der Bereitstellung entfernt.

Provisioning.RegenerateSshHostKeyPair

Typ: Boolesch

Standardwert: y

Wenn diese Option festgelegt ist, werden alle SSH-Hostschlüsselpaare (ecdsa, dsa und rsa) in /etc/ssh/ während der Bereitstellung gelöscht. und ein neues Schlüsselpaar generieren.

Der Verschlüsselungstyp des neuen Schlüsselpaars kann über den Eintrag Provisioning.SshHostKeyPairType konfiguriert werden. Beachten Sie, dass einige Distributionen SSH-Schlüsselpaare für fehlende Verschlüsselungstypen neu erstellen, wenn der SSH-Daemon neu gestartet wird (z. B. nach einem Neustart).

Provisioning.SshHostKeyPairType

HINWEIS: Diese Funktion hängt von den Ressourcennutzungsfunktionen des Agenten (cgroups) ab. Dieses Flag wird bei nicht unterstützten Distributionen nicht wirksam.

Logs.CollectPeriod

Typ: Ganzzahl

Standardwert: 3600

Dadurch wird konfiguriert, wie oft Protokolle erfasst und hochgeladen werden. Der Standardwert ist stündlich.

Hinweis: Dies wird nur wirksam, wenn die Option „Logs.Collect“ aktiviert ist.

OS.AllowHTTP

Typ: Boolesch

Standardwert: n

Wenn die SSL-Unterstützung nicht in Python kompiliert ist, schlägt der Proxy bei allen HTTPS-Anfragen fehl. Sie können diese Option auf „y“ setzen, damit der Proxy auf HTTP zurückgreift, anstatt die Anfrage fehlzuschlagen.

Hinweis: Durch das Zulassen von HTTP können unbeabsichtigt sichere Daten offengelegt werden.

OS.EnableRDMA

Typ: Boolesch

Standardwert: n

Wenn diese Option festgelegt ist, versucht der Agent, einen RDMA-Kerneltreiber zu installieren und zu laden, der der Firmware-Version auf der zugrunde liegenden Hardware entspricht.

OS.EnableFIPS

Typ: Boolesch

Typ: Zeichenfolge

Standardwert: Customscript, Runcommand

Liste der Erweiterungen, die von den cgroups-Einschränkungen ausgeschlossen werden sollen. Dies sollte durch Kommas getrennt werden.

Telemetrie

WALinuxAgent sammelt und sendet Nutzungsdaten an Microsoft, um uns bei der Verbesserung unserer Produkte und Dienste zu helfen. Die gesammelten Daten werden verwendet, um den Dienstzustand zu verfolgen und bei Azure-Supportanfragen zu helfen. Die erhobenen Daten enthalten keine personenbezogenen Daten. Lesen Sie unsere Datenschutzerklärung, um mehr zu erfahren.

WALinuxAgent unterstützt derzeit nicht die Deaktivierung der Telemetrie. Um die Telemetrieerfassung zu deaktivieren, muss WALinuxAgent entfernt werden. Wenn Sie diese Funktionalität benötigen, öffnen Sie bitte ein Problem auf GitHub und beschreiben Sie Ihre Anforderungen.

Anhang

Wir pflegen in diesem Repository keine Verpackungsinformationen, aber einige Beispiele werden unten als Referenz aufgeführt. Informationen zur offiziell gepflegten Verpackung finden Sie im Downstream-Release-Repository.

Deb-Paket

Das offizielle Ubuntu WALinuxAgent-Paket finden Sie hier.

Einmal ausführen:

Installieren Sie die erforderlichen Pakete

`

sudo apt-get -y installiere ubuntu-dev-tools pbuilder python-all debhelper

`

Erstellen Sie eine Pbuilder-Umgebung

`

sudo pbuilder create --debootstrapopts --variant=buildd

`

Holen Sie sich waagent.dsc aus dem Downstream-Paket-Repository

Um ein Paket zu kompilieren, gehen Sie im obersten Verzeichnis wie folgt vor:

Erstellen Sie ein Quellcodepaket

`

dpkg-buildpackage -S

`

Paket erstellen

`

sudo pbuilder build waagent.dsc

`

Rufen Sie das erstellte Paket ab, das sich normalerweise in /var/cache/pbuilder/result befindet

rpm-Paket

Die folgenden Anweisungen beschreiben, wie RPM-Pakete erstellt werden.

Installieren Sie die Setuptools

`

curl https://bootstrap.pypa.io/ez_setup.py -o - |

`

Die folgenden Befehle erstellen die Binär- und Quell-RPMs:

`

python setup.py bdist_rpm

`

Dieses Projekt hat den Microsoft-Verhaltenskodex für Open Source Code übernommen. Weitere Informationen finden Sie in den häufig gestellten Fragen zum Verhaltenskodex oder wenden Sie sich bei weiteren Fragen oder Kommentaren an [email protected].

Beispiel:

Apache-2.0-Lizenz

Expandieren

Zusätzliche Informationen

Version 2.11.1.12
Typ Anderer Quellcode
Aktualisierungszeit 2024-11-04
Größe
Sprache Vereinfachtes Chinesisch

Ähnliche Anwendungen