Implantar um site estático em sua própria conta do Azure Static Web Apps

O que a conexão faz por você

Conectar sua própria conta do Azure Static Web Apps permite que você publique um site estático na sua conta do Azure Static Web Apps diretamente do seu painel do Zinn®. Você é o proprietário do projeto e da fatura; nós cuidamos do implantação, do domínio personalizado e dos registros DNS.

Antes de começar

Uma assinatura do Azure, um grupo de recursos para os sites e uma conta conectada do GitHub, GitLab ou Bitbucket contendo o código — o Azure Static Web Apps é compilado a partir de um repositório. O plano gratuito do Azure permite uso comercial e dois domínios personalizados por aplicativo.

1. Crie a chave no Azure Static Web Apps

O Azure chama isso de entidade de serviço. No centro de administração do Microsoft Entra, abra Entra ID → Registros de aplicativos → Novo registro, dê um nome a ele e Registre-o. Na página de visão geral do aplicativo, copie a ID do aplicativo (cliente) e a ID do diretório (locatário). Em seguida, abra Certificados e segredos → Segredos do cliente → Novo segredo do cliente, escolha uma duração e Adicione-o — copie o valor do segredo imediatamente, pois o Azure o exibe apenas uma vez.

No portal do Azure, abra o grupo de recursos que você deseja que usemos, depois acesse Controle de acesso (IAM) → Adicionar → Adicionar atribuição de função. Escolha a função Colaborador, atribua-a a Usuário, grupo ou entidade de serviço, pesquise o aplicativo pelo nome e clique em Revisar + atribuir. Anote o nome do grupo de recursos e a ID da assinatura à qual ele pertence (pesquise por Assinaturas no portal).

2. Conecte-o aqui

Abra Integrações no seu painel e escolha Conectar uma conta. Selecione Hospedagem estática (Netlify, Vercel) como o grupo e Azure Static Web Apps como a conta, preenchi ID do cliente, Segredo do cliente, ID do locatário, ID da assinatura e Grupo de recursos, e pressione Conectar conta.

Testamos o que você cola antes que qualquer coisa seja salva. Uma chave que não funciona nunca é armazenada, e a resposta indica o que estava errado com ela. Uma chave que funciona é mantida criptografada em nosso cofre de segredos — nunca em nosso banco de dados — e nunca mais é exibida, nem mesmo para você.

O que acontece em seguida

• Quando você cria ou move um site estático, esta conta aparece como um destino

de implantação. O Azure Static Web Apps compila a partir de um repositório — ele não tem como aceitar uma compilação enviada — portanto, o código do site deve vir de um repositório conectado do GitHub, GitLab ou Bitbucket. Conecte um primeiro, caso ainda não tenha feito.

• Criamos o serviço na sua conta, apontamos para o repositório, anexamos seu domínio personalizado

e acionamos as implantações. A página do domínio mostra qualquer registro DNS que o Azure Static Web Apps precise.

• O uso e o faturamento ficam na sua conta, visíveis no painel do seu próprio fornecedor.
• Um domínio raiz é verificado por um registro TXT e um subdomínio pelo seu CNAME; a página do domínio mostra

qual deles o seu domínio precisa.

Se não conectar

O Azure recusou a entidade de serviço. Ou o segredo do cliente expirou — eles sempre expiram, na duração que você escolheu — ou o aplicativo não tem mais a função de Colaborador no grupo de recursos. As duas mensagens parecem semelhantes, portanto, verifique a atribuição de função antes de criar um novo segredo.

Nada é encontrado. Verifique se a ID da assinatura e o Grupo de recursos são aqueles aos quais você atribuiu a função e se a ID do locatário é o diretório em que o aplicativo está registrado.

Diz que a chave foi rejeitada. Quase sempre uma de três coisas: um espaço ou uma quebra de linha copiada junto, uma chave que expirou ou uma chave que foi revogada ou regenerada após você tê-la copiado. Crie uma nova e cole-a novamente.

Conecta, mas algo falha posteriormente. A chave se autentica, mas não tem uma permissão de que a ação precisa. Crie uma nova chave com as permissões listadas acima, desconecte a conexão antiga e conecte a nova chave.

Desconectando

Abra Integrações, localize a conta e pressione Desconectar. Isso exclui a chave armazenada imediatamente. Tudo o que a utilizava para na próxima ação, e as telas que dependiam dela informam isso em vez de falharem silenciosamente.

A desconexão não desfaz o que já foi feito — registros, implantações ou configurações que alteramos na sua conta permanecem como estão. Se você acha que a chave em si pode ter vazado, revogue-a também no fornecedor; a desconexão remove nossa cópia, não a deles.