Criar imagens generalizadas sem um agente de aprovisionamento
Aplica-se a: ✔️ Conjuntos de dimensionamento flexíveis de VMs ✔️ do Linux
O Microsoft Azure fornece agentes de aprovisionamento para VMs do Linux sob a forma de walinuxagent ou cloud-init (recomendado). No entanto, pode haver um cenário em que não quer utilizar nenhuma destas aplicações para o seu agente de aprovisionamento, como:
- A distribuição/versão do Linux não suporta o Agente cloud-init/Linux.
- É necessário definir propriedades específicas da VM, como o nome do anfitrião.
Nota
Se não exigir que quaisquer propriedades sejam definidas ou qualquer forma de aprovisionamento acontecer, deve considerar criar uma imagem especializada.
Este artigo mostra como pode configurar a sua imagem de VM para satisfazer os requisitos da plataforma do Azure e definir o nome do anfitrião, sem instalar um agente de aprovisionamento.
Rede e relatórios prontos
Para que a VM do Linux comunique com os componentes do Azure, é necessário um cliente DHCP. O cliente é utilizado para obter um IP anfitrião, resolução de DNS e gestão de rotas a partir da rede virtual. A maioria das distribuições são lançadas com estes utilitários desativados. As ferramentas testadas no Azure por fornecedores de distribuição do Linux incluem dhclient
, network-manager
e systemd-networkd
outros.
Nota
Atualmente, a criação de imagens generalizadas sem um agente de aprovisionamento só suporta VMs ativadas para DHCP.
Depois de configurar a rede, selecione "relatório pronto". Isto indica ao Azure que a VM foi aprovisionada com êxito.
Importante
Se não conseguir reportar pronto para o Azure, a VM será reiniciada!
Demonstração/exemplo
Uma imagem existente do Marketplace (neste caso, uma VM Debian Buster) com o Agente linux (walinuxagent) removido e um script python personalizado adicionado é a forma mais fácil de dizer ao Azure que a VM está "pronta".
Crie o grupo de recursos e a VM base:
$ az group create --location eastus --name demo1
Crie a VM base:
$ az vm create \
--resource-group demo1 \
--name demo1 \
--location eastus \
--ssh-key-value <ssh_pub_key_path> \
--public-ip-address-dns-name demo1 \
--image "debian:debian-10:10:latest"
Remover o Agente de aprovisionamento de imagens
Assim que a VM estiver a aprovisionar, pode ligar-se à mesma através de SSH e remover o Agente do Linux:
$ sudo apt purge -y waagent
$ sudo rm -rf /var/lib/waagent /etc/waagent.conf /var/log/waagent.log
Adicionar o código necessário à VM
Também dentro da VM, porque removemos o Agente Linux do Azure, precisamos de fornecer um mecanismo para preparar o relatório.
Script de Python
import http.client
import sys
from xml.etree import ElementTree
wireserver_ip = '168.63.129.16'
wireserver_conn = http.client.HTTPConnection(wireserver_ip)
print('Retrieving goal state from the Wireserver')
wireserver_conn.request(
'GET',
'/machine?comp=goalstate',
headers={'x-ms-version': '2012-11-30'}
)
resp = wireserver_conn.getresponse()
if resp.status != 200:
print('Unable to connect with wireserver')
sys.exit(1)
wireserver_goalstate = resp.read().decode('utf-8')
xml_el = ElementTree.fromstring(wireserver_goalstate)
container_id = xml_el.findtext('Container/ContainerId')
instance_id = xml_el.findtext('Container/RoleInstanceList/RoleInstance/InstanceId')
incarnation = xml_el.findtext('Incarnation')
print(f'ContainerId: {container_id}')
print(f'InstanceId: {instance_id}')
print(f'Incarnation: {incarnation}')
# Construct the XML response we need to send to Wireserver to report ready.
health = ElementTree.Element('Health')
goalstate_incarnation = ElementTree.SubElement(health, 'GoalStateIncarnation')
goalstate_incarnation.text = incarnation
container = ElementTree.SubElement(health, 'Container')
container_id_el = ElementTree.SubElement(container, 'ContainerId')
container_id_el.text = container_id
role_instance_list = ElementTree.SubElement(container, 'RoleInstanceList')
role = ElementTree.SubElement(role_instance_list, 'Role')
instance_id_el = ElementTree.SubElement(role, 'InstanceId')
instance_id_el.text = instance_id
health_second = ElementTree.SubElement(role, 'Health')
state = ElementTree.SubElement(health_second, 'State')
state.text = 'Ready'
out_xml = ElementTree.tostring(
health,
encoding='unicode',
method='xml'
)
print('Sending the following data to Wireserver:')
print(out_xml)
wireserver_conn.request(
'POST',
'/machine?comp=health',
headers={
'x-ms-version': '2012-11-30',
'Content-Type': 'text/xml;charset=utf-8',
'x-ms-agent-name': 'custom-provisioning'
},
body=out_xml
)
resp = wireserver_conn.getresponse()
print(f'Response: {resp.status} {resp.reason}')
wireserver_conn.close()
Script do Bash
#!/bin/bash
attempts=1
until [ "$attempts" -gt 5 ]
do
echo "obtaining goal state - attempt $attempts"
goalstate=$(curl --fail -v -X 'GET' -H "x-ms-agent-name: azure-vm-register" \
-H "Content-Type: text/xml;charset=utf-8" \
-H "x-ms-version: 2012-11-30" \
"http://168.63.129.16/machine/?comp=goalstate")
if [ $? -eq 0 ]
then
echo "successfully retrieved goal state"
retrieved_goal_state=true
break
fi
sleep 5
attempts=$((attempts+1))
done
if [ "$retrieved_goal_state" != "true" ]
then
echo "failed to obtain goal state - cannot register this VM"
exit 1
fi
container_id=$(grep ContainerId <<< "$goalstate" | sed 's/\s*<\/*ContainerId>//g' | sed 's/\r$//')
instance_id=$(grep InstanceId <<< "$goalstate" | sed 's/\s*<\/*InstanceId>//g' | sed 's/\r$//')
ready_doc=$(cat << EOF
<?xml version="1.0" encoding="utf-8"?>
<Health xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<GoalStateIncarnation>1</GoalStateIncarnation>
<Container>
<ContainerId>$container_id</ContainerId>
<RoleInstanceList>
<Role>
<InstanceId>$instance_id</InstanceId>
<Health>
<State>Ready</State>
</Health>
</Role>
</RoleInstanceList>
</Container>
</Health>
EOF
)
attempts=1
until [ "$attempts" -gt 5 ]
do
echo "registering with Azure - attempt $attempts"
curl --fail -v -X 'POST' -H "x-ms-agent-name: azure-vm-register" \
-H "Content-Type: text/xml;charset=utf-8" \
-H "x-ms-version: 2012-11-30" \
-d "$ready_doc" \
"http://168.63.129.16/machine?comp=health"
if [ $? -eq 0 ]
then
echo "successfully register with Azure"
break
fi
sleep 5 # sleep to prevent throttling from wire server
done
Passos genéricos (se não estiver a utilizar Python ou Bash)
Se a VM não tiver o Python instalado ou disponível, pode reproduzir programaticamente esta lógica de script acima com os seguintes passos:
Obtenha o
ContainerId
,InstanceId
eIncarnation
ao analisar a resposta do WireServer:curl -X GET -H 'x-ms-version: 2012-11-30' http://168.63.129.16/machine?comp=goalstate
.Construa os seguintes dados XML, injetando o analisado
ContainerId
,InstanceId
eIncarnation
a partir do passo acima:<Health> <GoalStateIncarnation>INCARNATION</GoalStateIncarnation> <Container> <ContainerId>CONTAINER_ID</ContainerId> <RoleInstanceList> <Role> <InstanceId>INSTANCE_ID</InstanceId> <Health> <State>Ready</State> </Health> </Role> </RoleInstanceList> </Container> </Health>
Publique estes dados no WireServer:
curl -X POST -H 'x-ms-version: 2012-11-30' -H "x-ms-agent-name: WALinuxAgent" -H "Content-Type: text/xml;charset=utf-8" -d "$REPORT_READY_XML" http://168.63.129.16/machine?comp=health
Automatizar a execução do código no primeiro arranque
Esta demonstração utiliza systemd, que é o sistema init mais comum nas distribuições modernas do Linux. Assim, a forma mais fácil e nativa de garantir que este mecanismo preparado para relatórios é executado no momento certo é criar uma unidade de serviço systemd. Pode adicionar o seguinte ficheiro de unidade a /etc/systemd/system
(este exemplo dá o nome de ficheiro azure-provisioning.service
de unidade ):
[Unit]
Description=Azure Provisioning
[Service]
Type=oneshot
ExecStart=/usr/bin/python3 /usr/local/azure-provisioning.py
ExecStart=/bin/bash -c "hostnamectl set-hostname $(curl \
-H 'metadata: true' \
'http://169.254.169.254/metadata/instance/compute/name?api-version=2019-06-01&format=text')"
ExecStart=/usr/bin/systemctl disable azure-provisioning.service
[Install]
WantedBy=multi-user.target
Este serviço systemd faz três coisas para o aprovisionamento básico:
- Relatórios prontos para o Azure (para indicar que surgiu com êxito).
- Muda o nome da VM com base no nome da VM fornecida pelo utilizador ao solicitar estes dados do Azure Instance Metadata Service (IMDS). Nota O IMDS também fornece outros metadados de instância, como Chaves Públicas SSH, para que possa definir mais do que o nome do anfitrião.
- Desativa-se para que seja executado apenas no primeiro arranque e não nos reinícios subsequentes.
Com a unidade no sistema de ficheiros, execute o seguinte para ativá-la:
$ sudo systemctl enable azure-provisioning.service
Agora, a VM está pronta para ser generalizada e tem uma imagem criada a partir da mesma.
Concluir a preparação da imagem
Novamente no computador de desenvolvimento, execute o seguinte para preparar a criação de imagens a partir da VM base:
$ az vm deallocate --resource-group demo1 --name demo1
$ az vm generalize --resource-group demo1 --name demo1
E crie a imagem a partir desta VM:
$ az image create \
--resource-group demo1 \
--source demo1 \
--location eastus \
--name demo1img
Agora, estamos prontos para criar uma nova VM a partir da imagem. Isto também pode ser utilizado para criar várias VMs:
$ IMAGE_ID=$(az image show -g demo1 -n demo1img --query id -o tsv)
$ az vm create \
--resource-group demo12 \
--name demo12 \
--location eastus \
--ssh-key-value <ssh_pub_key_path> \
--public-ip-address-dns-name demo12 \
--image "$IMAGE_ID"
--enable-agent false
Nota
É importante definir --enable-agent
como false
porque walinuxagent não existe nesta VM que vai ser criada a partir da imagem.
A VM deve ser aprovisionada com êxito. Depois de iniciar sessão na VM de aprovisionamento recente, deverá conseguir ver a saída do serviço systemd pronto para relatórios:
$ sudo journalctl -u azure-provisioning.service
-- Logs begin at Thu 2020-06-11 20:28:45 UTC, end at Thu 2020-06-11 20:31:24 UTC. --
Jun 11 20:28:49 thstringnopa systemd[1]: Starting Azure Provisioning...
Jun 11 20:28:54 thstringnopa python3[320]: Retrieving goal state from the Wireserver
Jun 11 20:28:54 thstringnopa python3[320]: ContainerId: 7b324f53-983a-43bc-b919-1775d6077608
Jun 11 20:28:54 thstringnopa python3[320]: InstanceId: fbb84507-46cd-4f4e-bd78-a2edaa9d059b._thstringnopa2
Jun 11 20:28:54 thstringnopa python3[320]: Sending the following data to Wireserver:
Jun 11 20:28:54 thstringnopa python3[320]: <Health><GoalStateIncarnation>1</GoalStateIncarnation><Container><ContainerId>7b324f53-983a-43bc-b919-1775d6077608</ContainerId><RoleInstanceList><Role><InstanceId>fbb84507-46cd-4f4e-bd78-a2edaa9d059b._thstringnopa2</InstanceId><Health><State>Ready</State></Health></Role></RoleInstanceList></Container></Health>
Jun 11 20:28:54 thstringnopa python3[320]: Response: 200 OK
Jun 11 20:28:56 thstringnopa bash[472]: % Total % Received % Xferd Average Speed Time Time Time Current
Jun 11 20:28:56 thstringnopa bash[472]: Dload Upload Total Spent Left Speed
Jun 11 20:28:56 thstringnopa bash[472]: [158B blob data]
Jun 11 20:28:56 thstringnopa2 systemctl[475]: Removed /etc/systemd/system/multi-user.target.wants/azure-provisioning.service.
Jun 11 20:28:56 thstringnopa2 systemd[1]: azure-provisioning.service: Succeeded.
Jun 11 20:28:56 thstringnopa2 systemd[1]: Started Azure Provisioning.
Suporte
Se implementar o seu próprio código/agente de aprovisionamento, então é o proprietário do suporte deste código, o suporte da Microsoft apenas investigará problemas relacionados com as interfaces de aprovisionamento que não estão disponíveis. Estamos continuamente a fazer melhorias e alterações nesta área, pelo que tem de monitorizar as alterações no cloud-init e no Agente Linux do Azure para aprovisionar alterações à API.
Passos seguintes
Para obter mais informações, veja Aprovisionamento do Linux.