Exercício - Instalar o tempo de execução do IoT Edge para Linux

15 minutos

Antes de começar, você precisará do seguinte:

Uma subscrição do Microsoft Azure. Se ainda não tiver uma, pode inscrever-se numa avaliação gratuita em https://azure.microsoft.com/free . Se você for um estudante, inscreva-se em uma conta do Azure para Estudantes .

Criar recursos na nuvem

Criar um grupo de recursos

Execute as seguintes etapas no ambiente do Azure Cloud Shell.

Selecione 'Bash' no canto superior esquerdo como o ambiente para o seu Cloud Shell.
Adicione a extensão do Azure IoT à instância do Cloud Shell.
```
az extension add --name azure-iot
```
Crie um grupo de recursos na localização eastus2 ao utilizar o seguinte comando. Atribua um nome ao seu grupo de recursos.
```
az group create --name <resource-group-name> --location eastus2   
```

Criar um dispositivo IoT Edge no hub IoT

Crie um Hub IoT de Camada F1 usando o comando a seguir. Dê um nome ao seu Hub IoT e substitua-o pelo seu grupo de recursos.
```
az iot hub create --resource-group <resource-group-name> --name <iot-hub-name> --sku F1 --partition-count 2  
```
É necessário registar um dispositivo no Hub IoT antes de poder ligar o mesmo. Execute o seguinte comando para criar uma identidade de dispositivo no seu Hub IoT. Dê um nome ao seu dispositivo IoT e substitua-o pelo seu Hub IoT.
```
az iot hub device-identity create --hub-name <iot-hub-name> --device-id <device-id>
```

Instalar o IoT Edge para Linux

Nota

Vá para a página da Microsoft, se quiser saber mais sobre como instalar o IoT Edge para Linux.

Abra o terminal no seu computador Linux.
Instale a configuração do repositório que corresponde ao sistema operacional do seu dispositivo.

Ubuntu Server 18.04:
```
curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list
```

Copie a lista gerada para o diretório sources.list.d.

sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/

Instale a chave pública Microsoft GPG.

curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/

Instalar um mecanismo de contêiner

O Azure IoT Edge depende de um tempo de execução de contêiner compatível com OCI. Para cenários de produção, recomendamos que você use o mecanismo Moby. O mecanismo Moby é o único mecanismo de contêiner oficialmente suportado com o Azure IoT Edge. As imagens de contêiner do Docker CE/EE são compatíveis com o tempo de execução do Moby.

Atualize as listas de pacotes no seu dispositivo.
```
sudo apt-get update
```
Instale o motor Moby.
```
sudo apt-get install moby-engine
```

Se você receber erros ao instalar o mecanismo de contêiner Moby, verifique se o kernel Linux é compatível com Moby. Alguns fabricantes de dispositivos incorporados enviam imagens de dispositivos que contêm kernels Linux personalizados sem os recursos necessários para a compatibilidade do mecanismo de contêiner. Execute o seguinte comando, que usa o script check-config fornecido pelo Moby, para verificar a configuração do kernel:

curl -sSL https://raw.githubusercontent.com/moby/moby/master/contrib/check-config.sh -o check-config.sh
chmod +x check-config.sh
./check-config.sh

Na saída do script, verifique se todos os itens em Generally Necessary e Network Drivers estão habilitados. Se você estiver faltando recursos, habilite-os reconstruindo seu kernel a partir do código-fonte e selecionando os módulos associados para inclusão no .config apropriado do kernel. Da mesma forma, se você estiver usando um gerador de configuração do kernel como defconfig ou menuconfig, encontre e habilite os respetivos recursos e reconstrua seu kernel de acordo. Depois de implantar seu kernel recém-modificado, execute o script check-config novamente para verificar se todos os recursos necessários foram habilitados com êxito.

Instalar o daemon de segurança do IoT Edge

O daemon de segurança do IoT Edge fornece e mantém padrões de segurança no dispositivo IoT Edge. O daemon é iniciado em cada inicialização e inicializa o dispositivo iniciando o restante do tempo de execução do IoT Edge.

Atualize as listas de pacotes no seu dispositivo.
```
sudo apt-get update
```
Verifique quais versões do IoT Edge estão disponíveis.
```
apt list -a iotedge
```
Instale a versão mais recente do daemon de segurança, use o seguinte comando que também instala a versão mais recente do pacote libiothsm-std :
```
sudo apt-get install iotedge
```

Provisionar o dispositivo com sua identidade na nuvem

Autenticar com chaves simétricas

Neste ponto, o tempo de execução do IoT Edge está instalado em seu dispositivo Linux e você precisa provisionar o dispositivo com sua identidade na nuvem e informações de autenticação.

Esta seção percorre as etapas para provisionar um dispositivo com autenticação de chave simétrica. Você deve ter registrado seu dispositivo no Hub IoT e recuperado a cadeia de conexão das informações do dispositivo.

No dispositivo IoT Edge, abra o arquivo de configuração.

sudo nano /etc/iotedge/config.yaml

Localize as configurações de provisionamento do arquivo e remova o comentário da configuração de provisionamento manual usando uma seção de cadeia de conexão , se ela ainda não tiver sido comentada.

```toml
# Manual provisioning configuration using a connection string
provisioning:
  source: "manual"
  device_connection_string: "<ADD DEVICE CONNECTION STRING HERE>"
```

Atualize o valor de device_connection_string com a cadeia de conexão do seu dispositivo IoT Edge. Certifique-se de que todas as outras seções de provisionamento sejam comentadas. Verifique se a linha de provisionamento não tem espaço em branco anterior e se os itens aninhados são recuados por dois espaços.

Para colar o conteúdo da área de transferência no Nano Shift+Right, clique ou pressione Shift+Insert.

Guarde e feche o ficheiro.

CTRL + X`, `Y`, `Enter

Depois de inserir as informações de provisionamento no arquivo de configuração, reinicie o daemon:

sudo systemctl restart iotedge

Verificar a configuração bem-sucedida

Verifique se o tempo de execução foi instalado e configurado com êxito no seu dispositivo IoT Edge.

Verifique se o serviço do sistema IoT Edge está em execução.

sudo systemctl status iotedge