[{"_1":2,"_155":-5,"_156":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_134":135},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_125":-5,"_126":11,"_127":17,"_128":11,"_129":-5,"_130":11,"_131":-5,"_132":133},"canonicalUrl","https://hub.docker.com/r/nathanleclaire/walinuxagent/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","nathanleclaire","reponame","walinuxagent","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":-5,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":17,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2016-06-06T23:56:44.452602Z","description","Dockerized version of the Windows Azure Linux agent.","is_private","last_updated","2016-06-15T05:52:50.395465Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",951,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","## Microsoft Azure Linux Agent README\n\n### INTRODUCTION\n\nThe Microsoft Azure Linux Agent (waagent) manages Linux & FreeBSD provisioning,\nand VM interaction with the Azure Fabric Controller. It provides the following\nfunctionality for Linux and FreeBSD IaaS deployments:\n\n * Image Provisioning\n - Creation of a user account\n - Configuring SSH authentication types\n - Deployment of SSH public keys and key pairs\n - Setting the host name\n - Publishing the host name to the platform DNS\n - Reporting SSH host key fingerprint to the platform\n - Resource Disk Management\n - Formatting and mounting the resource disk\n - Configuring swap space\n\n * Networking\n - Manages routes to improve compatibility with platform DHCP servers\n - Ensures the stability of the network interface name\n\n * Kernel\n - Configure virtual NUMA (disable for kernel <2.6.37)\n - Consume Hyper-V entropy for /dev/random\n - Configure SCSI timeouts for the root device (which could be remote)\n\n * Diagnostics\n - Console redirection to the serial port\n\n * SCVMM Deployments\n - Detect and bootstrap the VMM agent for Linux when running in a System\n Center Virtual Machine Manager 2012R2 environment\n\n * VM Extension\n - Inject component authored by Microsoft and Partners into Linux VM (IaaS)\n to enable software and configuration automation\n - VM Extension reference implementation on https://github.com/Azure/azure-linux-extensions\n\n\n### COMMUNICATION\n\nThe information flow from the platform to the agent occurs via two channels:\n\n * A boot-time attached DVD for IaaS deployments.\n This DVD includes an OVF-compliant configuration file that includes all\n provisioning information other than the actual SSH keypairs.\n\n * A TCP endpoint exposing a REST API used to obtain deployment and topology\n configuration.\n\n\n### REQUIREMENTS\n\nThe following systems have been tested and are known to work with the Azure\nLinux Agent. Please note that this list may differ from the official list\nof supported systems on the Microsoft Azure Platform as described here:\nhttp://support.microsoft.com/kb/2805216\n\n Supported Linux Distributions:\n * CoreOS\n * CentOS 6.2+\n * Debian 7.0+\n * Ubuntu 12.04+\n * openSUSE 12.3+\n * SLES 11 SP2+\n * Oracle Linux 6.4+\n\n Other Supported Systems:\n * FreeBSD 10+ (Azure Linux Agent v2.0.10+)\n\nWaagent depends on some system packages in order to function properly:\n\n * Python 2.6+\n * OpenSSL 1.0+\n * OpenSSH 5.3+\n * Filesystem utilities: sfdisk, fdisk, mkfs, parted\n * Password tools: chpasswd, sudo\n * Text processing tools: sed, grep\n * Network tools: ip-route\n\n\n### INSTALLATION\n\nInstallation via your distribution's package repository is preferred.\nYou can also customize your own RPM or DEB packages using the configuration\nfiles provided (see debian/README and rpm/README).\n\nFor more advanced installation options, such as installing to custom locations \nor prefixes, you can use ***setuptools*** to install from source by running:\n \n #sudo python setup.py install --register-service\n\nYou can view more installation options by running:\n\n #sudo python setup.py install --help\n\nThe agent's log file is kept at /var/log/waagent.log.\n\n### UPGRADE\n\nUpgrading via your distribution's package repository is preferred.\n\nIf upgrading manually, same with installation above by running:\n\n #sudo python setup.py install -force\n\nRestart waagent service,for most of linux distributions:\n\n #sudo service waagent restart\n\nFor Ubuntu, use:\n\n #sudo service walinuxagent restart\n\nFor CoreOS, use:\n\n #sudo systemctl restart waagent \n\nThe agent's log file is kept at /var/log/waagent.log.\n\n\n### COMMAND LINE OPTIONS\n\nFlags:\n\n -verbose: Increase verbosity of specified command\n\n -force: Skip interactive confirmation for some commands\n\nCommands:\n\n -help: Lists the supported commands and flags.\n\n -deprovision: Attempt to clean the system and make it suitable for\n re-provisioning. Deletes the following:\n * All SSH host keys\n (if Provisioning.RegenerateSshHostKeyPair is 'y' in the configuration\n file)\n * Nameserver configuration in /etc/resolv.conf\n * Root password from /etc/shadow\n (if Provisioning.DeleteRootPassword is 'y' in the configuration file)\n * Cached DHCP client leases.\n * Resets host name to localhost.localdomain.\n\n WARNING! Deprovision does not guarantee that the image is cleared of all\n sensitive information and suitable for redistribution.\n\n -deprovision+user: Performs everything under deprovision (above) and also\n deletes the last provisioned user account and associated data.\n\n -version: Displays the version of waagent\n\n -serialconsole: Configures GRUB to mark ttyS0 (the first serial port) as\n the boot console. This ensures that kernel bootup logs are sent to the\n serial port and made available for debugging.\n\n -daemon: Run waagent as a daemon to manage interaction with the platform.\n This argument is specified to waagent in the waagent init script.\n\n -start: Run waagent as a background process\n\n### CONFIGURATION\n\nA configuration file (/etc/waagent.conf) controls the actions of\nwaagent. A sample configuration file is shown below:\n\n```\nRole.StateConsumer=None\nRole.ConfigurationConsumer=None\nRole.TopologyConsumer=None\nProvisioning.Enabled=y\nProvisioning.DeleteRootPassword=n\nProvisioning.RegenerateSshHostKeyPair=y\nProvisioning.SshHostKeyPairType=rsa\nProvisioning.MonitorHostName=y\nProvisioning.DecodeCustomData=n\nProvisioning.ExecuteCustomData=n\nProvisioning.PasswordCryptId=6\nProvisioning.PasswordCryptSaltLength=10\nResourceDisk.Format=y\nResourceDisk.Filesystem=ext4\nResourceDisk.MountPoint=/mnt/resource\nResourceDisk.EnableSwap=n\nResourceDisk.SwapSizeMB=0\nLBProbeResponder=y\nLogs.Verbose=n\nOS.RootDeviceScsiTimeout=300\nOS.OpensslPath=None\nHttpProxy.Host=None\nHttpProxy.Port=None\n```\n\nThe various configuration options are described in detail below. Configuration\noptions are of three types : Boolean, String or Integer. The Boolean\nconfiguration options can be specified as \"y\" or \"n\". The special keyword \"None\"\nmay be used for some string type configuration entries as detailed below.\n\nConfiguration File Options:\n\nRole.StateConsumer:\nType: String Default: None\n\nIf a path to an executable program is specified, it is invoked when waagent has\nprovisioned the image and the \"Ready\" state is about to be reported to the\nFabric. The argument specified to the program will be \"Ready\". The agent will\nnot wait for the program to return before continuing.\n\nRole.ConfigurationConsumer:\nType: String Default: None\n\nIf a path to an executable program is specified, the program is invoked when the\nFabric indicates that a configuration file is available for the VM. The path to\nthe XML configuration file is provided as an argument to the executable. This\nmay be invoked multiple times whenever the configuration file changes. A sample\nfile is provided in the Appendix. Please note that the XML schema used in this\nfile may change in the future. The current path of this file is\n/var/lib/waagent/HostingEnvironmentConfig.xml.\n\nRole.TopologyConsumer:\nType: String Default: None\n\nIf a path to an executable program is specified, the program is invoked when the\nFabric indicates that a new network topology layout is available for the VM. The\npath to the XML configuration file is provided as an argument to the executable.\nThis may be invoked multiple times whenever the network topology changes (due to\nservice healing for example). A sample file is provided in the Appendix. Please\nnote that the XML schema used in this file may change in the future. The\ncurrent location of this file is /var/lib/waagent/SharedConfig.xml.\n\nProvisioning.Enabled:\nType: Boolean Default: y\n\nThis allows the user to enable or disable the provisioning functionality in the\nagent. Valid values are \"y\" or \"n\". If provisioning is disabled, SSH host and\nuser keys in the image are preserved and any configuration specified in the\nAzure provisioning API is ignored.\n\nProvisioning.DeleteRootPassword:\nType: Boolean Default: n\n\nIf set, the root password in the /etc/shadow file is erased during the\nprovisioning process.\n\nProvisioning.RegenerateSshHostKeyPair:\nType: Boolean Default: y\n\nIf set, all SSH host key pairs (ecdsa, dsa and rsa) are deleted during the\nprovisioning process from /etc/ssh/. And a single fresh key pair is generated.\nThe encryption type for the fresh key pair is configurable by the\nProvisioning.SshHostKeyPairType entry. Please note that some distributions will\nre-create SSH key pairs for any missing encryption types when the SSH daemon is\nrestarted (for example, upon a reboot).\n\nProvisioning.SshHostKeyPairType:\nType: String Default: rsa\n\nThis can be set to an encryption algorithm type that is supported by the SSH\ndaemon on the VM. The typically supported values are \"rsa\", \"dsa\" and \"ecdsa\".\nNote that \"putty.exe\" on Windows does not support \"ecdsa\". So, if you intend to\nuse putty.exe on Windows to connect to a Linux deployment, please use \"rsa\" or\n\"dsa\".\n\nProvisioning.MonitorHostName:\nType: Boolean Default: y\n\nIf set, waagent will monitor the Linux VM for hostname changes (as returned by\nthe \"hostname\" command) and automatically update the networking configuration in\nthe image to reflect the change. In order to push the name change to the DNS\nservers, networking will be restarted in the VM. This will result in brief loss\nof Internet connectivity.\n\nProvisioning.DecodeCustomData:\nType: Boolean Default: n\n\nIf set, waagent will decode CustomData from Base64.\n\nProvisioning.ExecuteCustomData:\nType: Boolean Default: n\n\nIf set, waagent will execute CustomData after provisioning.\n\nProvisioning.PasswordCryptId:\nType:String Default:6\n\nAlgorithm used by crypt when generating password hash.\n 1 - MD5\n 2a - Blowfish\n 5 - SHA-256\n 6 - SHA-512\n\nProvisioning.PasswordCryptSaltLength\nType:String Default:10\n\nLength of random salt used when generating password hash.\n\nResourceDisk.Format:\nType: Boolean Default: y\n\nIf set, the resource disk provided by the platform will be formatted and mounted\nby waagent if the filesystem type requested by the user in\n\"ResourceDisk.Filesystem\" is anything other than \"ntfs\". A single partition of\ntype Linux (83) will be made available on the disk. Note that this partition\nwill not be formatted if it can be successfully mounted.\n\nResourceDisk.Filesystem:\nType: String Default: ext4\n\nThis specifies the filesystem type for the resource disk. Supported values vary\nby Linux distribution. If the string is X, then mkfs.X should be present on the\nLinux image. SLES 11 images should typically use 'ext3'. FreeBSD images should\nuse 'ufs2' here.\n\nResourceDisk.MountPoint:\nType: String Default: /mnt/resource\n\nThis specifies the path at which the resource disk is mounted.\n\nResourceDisk.EnableSwap:\nType: Boolean Default: n\n\nIf set, a swap file (/swapfile) is created on the resource disk and added to the\nsystem swap space.\n\nResourceDisk.SwapSizeMB:\nType: Integer Default: 0\n\nThe size of the swap file in megabytes.\n\nLBProbeResponder:\nType: Boolean Default: y\n\nIf set, waagent will respond to load balancer probes from the platform (if\npresent).\n\nLogs.Verbose:\nType: Boolean Default: n\n\nIf set, log verbosity is boosted. Waagent logs to /var/log/waagent.log and\nleverages the system logrotate functionality to rotate logs.\n\nOS.RootDeviceScsiTimeout:\nType: Integer Default: 300\n\nThis configures the SCSI timeout in seconds on the root device. If not set, the\nsystem defaults are used.\n\nOS.OpensslPath:\nType: String Default: None\n\nThis can be used to specify an alternate path for the openssl binary to use for\ncryptographic operations.\n\nHttpProxy.Host=None\nHttpProxy.Port=None\nType: String Default: None\n\nIf set, agent will use proxy server to access internet\n\n### APPENDIX\n\nSample Role Configuration File:\n\n```\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n <r name="LinuxVM"><e\n name="HTTP" /><e\n name="Microsoft.WindowsAzure.Plugins.RemoteAccess.Rdp" /><e\n name="Microsoft.WindowsAzure.Plugins.RemoteForwarder.RdpInput"\n /><e name="SSH" /></r></m>\" />\n \n \n \n \n \n \n \n \n \n \n \n \n```\n\nSample Role Topology File:\n\n```\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n```\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",865633667,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},"content_type","creator",19140,"full_size",89090145,"id",3313512,"images",[97],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},"architecture","amd64","digest","sha256:31b7703303907f12e4e1106c411db3ae4bdfecee248859deb6e89bd85c985fbf","features","","last_pulled","2026-09-21T11:12:31.529206261Z","last_pushed","2016-06-15T05:52:50Z","os","linux","os_features","os_version","size","variant","2016-06-15T05:52:49.369915Z","last_updater","last_updater_username","media_type","latest","repository",728963,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":136,"_143":144,"_132":153,"_154":11},{"_36":137,"_38":138,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":139,"_53":31,"_28":29,"_54":55,"_56":-5,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":140,"_75":17,"_76":142,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":141},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_145":60,"_146":-5,"_147":-5,"_148":149},"count","next","previous","results",[150],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":151,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},[152],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

nathanleclaire/walinuxagent

Tags for nathanleclaire/walinuxagent