Compartilhar via


Implante o módulo Cache Conectado da Microsoft em um único gateway (versão prévia)

O módulo Cache Conectado da Microsoft (MCC) para gateways do IoT Edge habilita a Atualização de Dispositivo para dispositivos desconectados por trás do gateway. Este artigo apresenta duas configurações diferentes para implantar o módulo MCC em um gateway do IoT Edge.

Se você tiver vários gateways do IoT Edge encadeados, consulte as instruções em Implantar o módulo Cache Conectado da Microsoft em gateways aninhados.

Observação

Essas informações referem-se a uma versão prévia do recurso disponível para testes antecipados e uso em um ambiente de produção. Esse recurso tem suporte total, mas ainda está em desenvolvimento ativo e pode receber alterações substanciais até que ele fique disponível.

Implantar em um gateway sem proxy

O diagrama a seguir descreve o cenário em que um gateway do Azure IoT Edge tem acesso direto aos recursos da rede de distribuição de conteúdo (CDN) e tem o módulo Cache Conectado da Microsoft implantado nele. Atrás do gateway, há um dispositivo folha do IoT, como um Raspberry PI, que é um dispositivo filho isolado da Internet do gateway do IoT Edge.

Diagrama que mostra o módulo Cache Conectado da Microsoft em um gateway.

As etapas a seguir são um exemplo de configuração das variáveis do ambiente MCC para se conectar diretamente à CDN sem proxy:

  1. Adicione o módulo do Cache Conectado da Microsoft à sua implantação de dispositivo de gateway do Azure IoT Edge no Hub IoT do Azure (confira Suporte para dispositivos desconectados para obter detalhes sobre como obter o módulo).

  2. Adicione as variáveis de ambiente para a implantação. A tabela a seguir é um exemplo das variáveis de ambiente:

    Nome Valor
    CACHE_NODE_ID Confira as descrições da variável de ambiente
    CUSTOMER_ID Confira as descrições da variável de ambiente
    CUSTOMER_KEY Confira as descrições da variável de ambiente
    STORAGE_1_SIZE_GB 10
  3. Adicione as opções de criação de contêiner para a implantação. Por exemplo:

    {
        "HostConfig": {
            "Binds": [
                "/MicrosoftConnectedCache1/:/nginx/cache1/"
            ],
            "PortBindings": {
                "8081/tcp": [
                    {
                        "HostPort": "80"
                    }
                ],
                "5000/tcp": [
                    {
                        "HostPort": "5100"
                    }
                ]
            }
        }
    }
    

Para a validar se o Cache Conectado da Microsoft está funcionando corretamente, execute o comando a seguir no terminal do dispositivo IoT Edge que hospeda o módulo ou qualquer dispositivo na rede. Substitua o <IP de Gateway do Azure IoT Edge> pelo endereço IP ou pelo nome do host do gateway do IoT Edge. Para obter informações sobre a visibilidade desse relatório, confira o Relatório de resumo do Cache Conectado da Microsoft.

wget http://<IoT Edge Gateway IP>/mscomtest/wuidt.gif?cacheHostOrigin=au.download.windowsupdate.com

Implantar em um gateway com proxy não autenticado de saída

Nesse cenário, um Gateway do Azure IoT Edge tem acesso aos recursos da rede de distribuição de conteúdo (CDN) por meio de um proxy não autenticado de saída. O Cache Conectado da Microsoft é configurado para armazenar em cache o conteúdo de um repositório personalizado e o relatório de resumo fica visível para qualquer pessoa na rede.

Diagrama que mostra o módulo Cache Conectado da Microsoft em um gateway atrás de um proxy.

As etapas a seguir são um exemplo de configuração das variáveis de ambiente MCC para dar suporte um proxy de saída não autenticado:

  1. Adicione o módulo de Cache Conectado da Microsoft à sua implantação de dispositivo de gateway do Azure IoT Edge no Hub IoT do Azure.

  2. Adicione as variáveis de ambiente para a implantação. Veja abaixo um exemplo das variáveis de ambiente.

    Nome Valor
    CACHE_NODE_ID Confira as descrições da variável de ambiente
    CUSTOMER_ID Confira as descrições da variável de ambiente
    CUSTOMER_KEY Confira as descrições da variável de ambiente
    STORAGE_1_SIZE_GB 10
    CACHEABLE_CUSTOM_1_HOST Packagerepo.com:80
    CACHEABLE_CUSTOM_1_CANONICAL Packagerepo.com
    IS_SUMMARY_ACCESS_UNRESTRICTED true
    UPSTREAM_PROXY IP ou FQDN do servidor proxy
  3. Adicione as opções de criação de contêiner para a implantação. Por exemplo:

    {
        "HostConfig": {
            "Binds": [
                "/MicrosoftConnectedCache1/:/nginx/cache1/"
            ],
            "PortBindings": {
                "8081/tcp": [
                    {
                        "HostPort": "80"
                    }
                ],
                "5000/tcp": [
                    {
                        "HostPort": "5100"
                    }
                ]
            }
        }
    }
    

Para a validar se o Cache Conectado da Microsoft está funcionando corretamente, execute o comando a seguir no terminal do dispositivo Azure IoT Edge que hospeda o módulo ou qualquer dispositivo na rede. Substitua o <IP de Gateway do Azure IoT Edge> pelo endereço IP ou pelo nome do host do gateway do IoT Edge. Para obter informações sobre a visibilidade desse relatório, confira o Relatório de resumo do Cache Conectado da Microsoft.

wget http://<Azure IoT Edge Gateway IP>/mscomtest/wuidt.gif?cacheHostOrigin=au.download.windowsupdate.com