Tutorial: Transformar dados com a FPGA do Azure Stack Edge Pro para o fluxo de implantação avançada

Artigo
02/27/2024

Importante

Os dispositivos FPGA do Azure Stack Edge Pro atingirão o fim da vida útil em fevereiro de 2024.

Este tutorial descreve como configurar uma função de computação para um fluxo de implantação avançada no dispositivo FPGA do Azure Stack Edge Pro. Depois que você configura a função de computação, a FPGA do Azure Stack Edge Pro pode transformar os dados antes de enviá-los ao Azure.

Computação pode ser configurada para o fluxo de implantação simples ou avançada em seu dispositivo.

Critérios	Implantação simples	Implantação avançada
Destinado a	Administradores de TI	Desenvolvedores
Type	Usar o serviço Azure Stack Edge para implantar módulos	Usar o serviço de Hub IoT para implantar módulos
Módulos implantados	Single	Módulos múltiplos ou encadeados

Esse procedimento pode levar cerca de 20 a 30 minutos para ser concluído.

Neste tutorial, você aprenderá como:

Configurar a computação
Adicionar compartilhamentos
Adicionar um gatilho
Adicionar um módulo de computação
Verificar a transformação e a transferência de dados

Pré-requisitos

Antes de configurar uma função de computação no dispositivo da FPGA do Azure Stack Edge Pro, verifique se:

Você ativou o dispositivo da FPGA do Azure Stack Edge Pro conforme descrito em Conectar, configurar e ativar a FPGA do Azure Stack Edge Pro.

Configurar a computação

Para configurar a computação na FPGA do Azure Stack Edge Pro, você criará um recurso do Hub IoT.

No portal do Azure do recurso do Azure Stack Edge, acesse Visão geral. No painel direito, selecione o bloco IoT Edge.
No bloco Habilitar o serviço IoT Edge, selecione Adicionar. Essa ação habilita o serviço do IoT Edge que lhe permite implantar os módulos do IoT Edge localmente em seu dispositivo.

Em Criar serviço do IoT Edge, insira o seguinte:

Campo	Valor
Subscription	Selecione uma assinatura para o recurso do Hub IoT. Você pode selecionar a mesma assinatura usada pelo recurso Azure Stack Edge.
Grupo de recursos	Insira um nome para o grupo de recursos para o recurso do Hub IoT. Você pode selecionar o mesmo grupo de recursos usado pelo recurso do Azure Stack Edge.
Hub IoT	Escolha Novo ou Existente. Por padrão, uma camada Standard (S1) é usada para criar um recurso de IoT. Para usar um recurso de IoT de Camada gratuita, crie um e, em seguida, selecione o recurso existente.
Nome	Aceite o padrão ou insira um nome para o recurso do Hub IoT.

Introdução à computação 3

Selecione Examinar + criar. A criação do recurso do Hub IoT leva alguns minutos. Depois da criação do recurso do Hub IoT, a visão geral é atualizada para indicar que o serviço IoT Edge está em execução.

Quando o serviço de IoT Edge é configurado no dispositivo de borda, ele cria dois dispositivos: um dispositivo IoT e um dispositivo IoT Edge. Os dois dispositivos podem ser exibidos no recurso do Hub IoT. Um runtime do IoT Edge também está em execução no dispositivo do IoT Edge. No momento, somente a plataforma Linux está disponível para o dispositivo IoT Edge.

Para confirmar que a função de Computação de borda foi configurada, selecione Serviço IoT Edge > Propriedades e veja o dispositivo IoT e o dispositivo do IoT Edge.

Adicionar compartilhamentos

Para a implantação avançada neste tutorial, você precisará de dois compartilhamentos: um compartilhamento do Edge e outro compartilhamento local do Edge.

Adicione um compartilhamento do Microsoft Edge no dispositivo seguindo as seguintes etapas:
1. Em seu recurso do Azure Stack Edge, acesse IoT Edge > Compartilhamentos.
2. Na página Compartilhamentos, na barra de comandos, selecione + Adicionar compartilhamento.
3. Na folha Adicionar compartilhamento, forneça o nome do compartilhamento e selecione o tipo de compartilhamento.
4. Para montar o compartilhamento do Microsoft Edge, marque a caixa de seleção Usar o compartilhamento com a computação de borda.
5. Selecione a Conta de armazenamento, o Serviço de armazenamento, um usuário existente e, em seguida, selecione Criar.
Após o compartilhamento do Edge ser criado, você receberá uma notificação de êxito na criação. A lista de compartilhamentos é atualizada para refletir o novo compartilhamento.
Adicione um compartilhamento local do Microsoft Edge no dispositivo do Microsoft Edge repetindo todas as etapas da etapa anterior e marcando a caixa de seleção Configurar como o compartilhamento local do Microsoft Edge. Os dados no compartilhamento local permanecem no dispositivo.
Na folha Compartilhamentos, você vê a lista de compartilhamentos atualizada.
Para exibir as propriedades do compartilhamento local recém-criado, basta selecioná-lo na lista. Na caixa Ponto de montagem local para módulos de computação de borda, copie o valor correspondente a esse compartilhamento.

Você usará esse ponto de montagem local ao implantar o módulo.
Para exibir as propriedades do compartilhamento do Edge recém-criado, selecione-o na lista. Na caixa Ponto de montagem local para módulos de computação de borda, copie o valor correspondente a esse compartilhamento.

Você usará esse ponto de montagem local ao implantar o módulo.

Adicionar um gatilho

Vá para o recurso do Azure Stack Edge e para IoT Edge > Gatilhos. Selecione + Adicionar gatilho.

Na folha Adicionar gatilho, adicione os valores de entrada a seguir.

Campo	Valor
Nome do gatilho	Um nome exclusivo para o gatilho.
Tipo de gatilho	Selecione o gatilho Arquivo. Um gatilho de arquivo é acionado sempre que ocorre um evento de arquivo, como uma gravação de arquivo no compartilhamento de entrada. Um gatilho agendado, por sua vez, é acionado de acordo com um agendamento definido por você. Neste exemplo, precisamos de um gatilho de arquivo.
Compartilhamento de entrada	Selecione um compartilhamento de entrada. O compartilhamento local do Microsoft Edge é o compartilhamento de entrada, nesse caso. O módulo usado aqui move os arquivos do compartilhamento local do Microsoft Edge para um compartilhamento do Microsoft Edge, em que são carregados para a nuvem.

Adicionar gatilho 2

Você será notificado depois que o gatilho for criado. A lista de gatilhos é atualizada para exibir o gatilho criado recentemente. Selecione o gatilho que você acabou de criar.
Copie e salve a rota de exemplo. Você modificará essa rota de exemplo e a usará mais tarde no Hub IoT.

"sampleroute": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/modulename/inputs/input1\")"

Adicionar um módulo

Não há módulos personalizados neste dispositivo do Edge. Você pode adicionar um módulo personalizado ou pré-criado. Para saber como criar um módulo personalizado, acesse Desenvolver um módulo em C# para o dispositivo FPGA do Azure Stack Edge Pro.

Nesta seção, você adicionará um módulo personalizado ao dispositivo do IoT Edge criado em Desenvolver um módulo em C# para a FPGA do Azure Stack Edge Pro. Esse módulo personalizado usa arquivos de um compartilhamento local do Microsoft Edge no dispositivo do Microsoft Edge e move-os para um compartilhamento do Microsoft Edge (nuvem) no dispositivo. O compartilhamento em nuvem então efetua o push dos arquivos para a conta de Armazenamento do Azure associada com o compartilhamento em nuvem.

Vá para o recurso do Azure Stack Edge e para IoT Edge > Visão geral. No bloco Módulos, selecione Ir para Hub IoT do Azure.

No recurso do Hub IoT, acesse Dispositivo do IoT Edge e, em seguida, selecione seu dispositivo do IoT Edge.
Em Detalhes do dispositivo, selecione Definir Módulos.

Em Adicionar Módulos, faça o seguinte:

Insira o nome, o endereço, o nome de usuário e a senha para as configurações do registro de contêiner do módulo personalizado. O nome, o endereço e as credenciais listadas são usados para recuperar módulos com uma URL correspondente. Para implantar este módulo, em Módulos de implantação, selecione Módulo do IoT Edge. Esse módulo do IoT Edge é um contêiner do Docker que você pode implantar no dispositivo do IoT Edge associado ao dispositivo FPGA do Azure Stack Edge Pro.

Especifique as configurações para o módulo personalizado do IoT Edge. Insira os valores a seguir.

Campo	Valor
Nome	Um nome exclusivo para o módulo. Esse módulo é um contêiner do Docker que você pode implantar no dispositivo do IoT Edge associado à FPGA do Azure Stack Edge Pro.
URI da imagem	O URI da imagem para a imagem de contêiner correspondente ao módulo.
Credenciais necessárias	Se essa opção for marcada, o nome de usuário e a senha serão usados para recuperar os módulos com uma URL correspondente.

Na caixa Opções de Criação de Contêiner, insira os pontos de montagem locais dos módulos do Edge que você copiou nas etapas anteriores para o compartilhamento do Edge e o compartilhamento local do Edge.

Importante

Os caminhos usados aqui são montados em seu contêiner, portanto, eles devem coincidir com o que a funcionalidade em seu contêiner espera. Se você está seguindo as instruções em Criar um módulo personalizado, o código especificado nesse módulo espera os caminhos copiados. Não modifique esses caminhos.

Na caixa Opções de Criação de Contêiner, cole o exemplo a seguir:

{
  "HostConfig": 
  {
   "Binds": 
    [
     "/home/hcsshares/mydbesmbedgelocalshare1:/home/input",
     "/home/hcsshares/mydbesmbedgeshare1:/home/output"
    ]
   }
}

Forneça também todas as variáveis de ambiente usadas para seu módulo. Variável de ambiente fornecem informações opcionais que ajudam a definir o ambiente no qual o módulo é executado.

A caixa Opções de Criação de Contêiner

Se necessário, defina as configurações avançadas de runtime do Edge e, em seguida, clique em Avançar.

Em Especificar Rotas, defina rotas entre módulos.

Você pode substituir rota pela cadeia de caracteres a seguir, que você copiou anteriormente. Neste exemplo, insira o nome do compartilhamento local que efetuará push de dados para o compartilhamento de nuvem. Substitua o modulename pelo nome do módulo. Selecione Avançar.
```
"route": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/filemove/inputs/input1\")"
```
Em Examinar implantação, examine todas as configurações e, em seguida, selecione Enviar para enviar o módulo para implantação.

Essa ação inicia a implantação do módulo. Depois que a implantação for concluída, o Status de runtime do módulo será em execução.

Verificar a transformação e a transferência de dados

A etapa final é garantir que o módulo esteja conectado e funcionando como esperado. O status de tempo de execução do módulo deve estar em execução para seu dispositivo IoT Edge no recurso do Hub IoT.

Execute as etapas a seguir para verificar a transformação e transferência de dados para o Azure.

No Explorador de Arquivos, conecte-se aos compartilhamentos do Microsoft Edge e local do Microsoft Edge criados anteriormente.
Adicione dados ao compartilhamento de local.

Os dados são movidos para o compartilhamento em nuvem.

Os dados são então enviados por push do compartilhamento em nuvem para a conta de armazenamento. Para exibir os dados, vá para sua conta de armazenamento e, em seguida, selecione Gerenciador de Armazenamento. Você pode exibir os dados carregados em sua conta de armazenamento.