Implante 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 a partir do seu painel Zinn®. Você é o proprietário do projeto e da fatura; nós cuidamos da 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 que contenha o código — o Azure Static Web Apps compila 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 service principal. No centro de administração do Microsoft Entra, abra Entra ID → App registrations → New registration, dê um nome a ele e clique em Register. Na página de visão geral do aplicativo, copie o Application (client) ID e o Directory (tenant) ID. Em seguida, abra Certificates & secrets → Client secrets → New client secret, escolha uma duração e clique em Add — copie o valor do segredo imediatamente, pois o Azure só o exibe uma vez.

No portal do Azure, abra o grupo de recursos que deseja que usemos e, em seguida, acesse Access control (IAM) → Add → Add role assignment. Escolha a função Contributor, atribua-a a User, group, or service principal, pesquise pelo aplicativo pelo nome e clique em Review + assign. Anote o nome do grupo de recursos e o Subscription ID ao qual ele pertence (pesquise por Subscriptions no portal).

2. Conecte aqui

Abra Integrations no seu painel e escolha Connect an account. Selecione Static hosting (Netlify, Vercel) como o grupo e Azure Static Web Apps como a conta, preencha Client ID, Client secret, Tenant ID, Subscription ID e Resource group, e pressione Connect account.

Testamos o que você cola antes que qualquer coisa seja salva. Uma chave que não funciona nunca é armazenada, e a resposta informa 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 a seguir

• 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 — não há como aceitar um build enviado diretamente —, portanto, o código do site deve vir de um repositório conectado do GitHub, GitLab ou Bitbucket. Conecte um primeiro se ainda não o tiver feito.
• Criamos o serviço na sua conta, apontamos para o repositório, vinculamos seu domínio personalizado e acionamos implantações. A página do domínio mostra qualquer registro DNS de que o Azure Static Web Apps precise.
• O uso e o faturamento ficam na sua conta, visíveis no painel do seu próprio provedor.
• Um domínio ápice é verificado por um registro TXT e um subdomínio por seu CNAME; a página do domínio mostra qual deles o seu domínio precisa.

Se não conectar

O Azure recusou o service principal. Ou o segredo do cliente expirou — eles sempre expiram, no prazo que você escolheu — ou o aplicativo não possui mais a função Contributor no grupo de recursos. As duas mensagens são parecidas, portanto verifique a atribuição de função antes de criar um novo segredo.

Nada foi encontrado. Verifique se o Subscription ID e o Resource group são aqueles aos quais você atribuiu a função, e se o Tenant ID é o diretório no qual 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 com ela, uma chave que expirou, ou uma chave que foi revogada ou gerada novamente após você tê-la copiado. Crie uma nova e cole-a novamente.

Conecta, mas algo falha depois. A chave autentica, mas não possui uma permissão necessária para a ação. Crie uma nova chave com as permissões listadas acima, depois desconecte a conexão antiga e conecte a nova chave.

Desconectando

Abra Integrations, localize a conta e pressione Disconnect. Isso exclui a chave armazenada imediatamente. Qualquer item que a estava utilizando será interrompido na sua próxima ação, e as telas que dependiam dela informarão 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 achar que a chave em si pode ter vazado, revogue-a também no provedor; a desconexão remove a nossa cópia, não a deles.