Início rápido: Usar o GitHub Actions para se conectar ao Banco de Dados do Azure para MySQL — Servidor Flexível
Comece a usar o GitHub Actions usando um fluxo de trabalho para implantar atualizações de banco de dados no Banco de Dados do Azure para MySQL — Servidor Flexível.
Pré-requisitos
Você precisará de:
Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
Uma conta do GitHub. Se você não tiver uma conta do GitHub, inscreva-se gratuitamente.
Um repositório do GitHub com os dados de exemplo (
data.sql
).Importante
Este início rápido pressupõe que você clonou um repositório GitHub no computador para adicionar o endereço IP associado a uma regra de firewall, se necessário.
Uma instância do Banco de Dados do Azure para MySQL — Servidor Flexível.
Visão geral do arquivo do fluxo de trabalho
Um fluxo de trabalho do GitHub Actions é definido por um arquivo YAML (.yml) no caminho /.github/workflows/
no repositório. Essa definição contém as várias etapas e os parâmetros que compõem o fluxo de trabalho.
O arquivo tem duas seções:
Seção | Tarefas |
---|---|
Autenticação | 1. Gerar as credenciais de implantação. |
Implantar | 1. Implantar o banco de dados. |
Gerar as credenciais de implantação
Crie uma entidade de serviço com o comando az ad sp create-for-rbac na CLI do Azure. Execute esse comando com o Azure Cloud Shell no portal do Azure ou selecionando o botão Experimentar.
az ad sp create-for-rbac --name "myML" --role contributor \
--scopes /subscriptions/<subscription-id>/resourceGroups/<group-name> \
--json-auth
O parâmetro --json-auth
está disponível nas versões da CLI do Azure >= 2.51.0. Versões anteriores a essa usam --sdk-auth
com um aviso de substituição.
No exemplo acima, substitua os espaços reservados pela ID da assinatura, nome do grupo de recursos e nome do aplicativo. A saída é um objeto JSON com as credenciais de atribuição de função que fornecem acesso ao aplicativo do Serviço de Aplicativo semelhante ao mostrado abaixo. Copie esse objeto JSON para uso posterior.
{
"clientId": "<GUID>",
"clientSecret": "<GUID>",
"subscriptionId": "<GUID>",
"tenantId": "<GUID>",
(...)
}
Copiar a cadeia de conexão de MySQL
No portal do Azure, acesse a instância do Banco de Dados do Azure para MySQL — Servidor Flexível e abra Configurações>Cadeias de conexão. Copie a cadeia de conexão ADO.NET. Substitua os valores de espaço reservado por your_database
e your_password
.
Importante
- Para o Banco de Dados do Azure para MySQL — Servidor Único, use Uid=adminusername@servername. Observe que @servername é obrigatório.
- Para o servidor flexível do Banco de Dados MySQL do Azure, use Uid=adminusername sem o @servername.
Você usará a cadeia de conexão como um segredo do GitHub.
Configurar segredos do GitHub
No GitHub, acesse seu repositório.
Acesse Configurações no menu de navegação.
Selecione Segurança > Segredos e variáveis > Ações.
Selecione Novo segredo de repositório.
Cole toda a saída JSON do comando da CLI do Azure no campo valor do segredo. Dê ao segredo o nome
AZURE_CREDENTIALS
.Selecione Adicionar segredo.
Adicionar seu fluxo de trabalho
Acesse Ações para seu repositório do GitHub.
Selecione Configurar seu fluxo de trabalho por conta própria.
Exclua tudo depois da seção
on:
do seu arquivo de fluxo de trabalho. Por exemplo, seu fluxo de trabalho restante pode ter esta aparência.name: CI on: push: branches: [ main ] pull_request: branches: [ main ]
Renomeie o fluxo de trabalho
MySQL for GitHub Actions
e adicione as ações de check-out e logon. Essas ações farão o check-out do código do site e a autenticação com o Azure usando o segredo do GitHubAZURE_CREDENTIALS
criado anteriormente.name: MySQL for GitHub Actions on: push: branches: [ main ] pull_request: branches: [ main ] jobs: build: runs-on: windows-latest steps: - uses: actions/checkout@v1 - uses: azure/login@v1 with: creds: ${{ secrets.AZURE_CREDENTIALS }}
Use a ação Implantar do MySQL do Azure para se conectar à sua instância do MySQL. Substitua
MYSQL_SERVER_NAME
pelo nome do seu servidor. Você deve ter um arquivo de dados do MySQL chamadodata.sql
no nível raiz do seu repositório.- uses: azure/mysql@v1 with: server-name: MYSQL_SERVER_NAME connection-string: ${{ secrets.AZURE_MYSQL_CONNECTION_STRING }} sql-file: './data.sql'
Conclua o fluxo de trabalho adicionando uma ação para fazer logoff do Azure. Este é o fluxo de trabalho concluído. O arquivo será exibido na pasta
.github/workflows
do seu repositório.name: MySQL for GitHub Actions on: push: branches: [ main ] pull_request: branches: [ main ] jobs: build: runs-on: windows-latest steps: - uses: actions/checkout@v1 - uses: azure/login@v1 with: creds: ${{ secrets.AZURE_CREDENTIALS }} - uses: azure/mysql@v1 with: server-name: MYSQL_SERVER_NAME connection-string: ${{ secrets.AZURE_MYSQL_CONNECTION_STRING }} sql-file: './data.sql' # Azure logout - name: logout run: | az logout
Examinar sua implantação
Acesse Ações para seu repositório do GitHub.
Abra o primeiro resultado para ver os logs detalhados da execução do fluxo de trabalho.
Limpar os recursos
Quando o banco de dados e o repositório do Banco de Dados do Azure para MySQL — Servidor Flexível não forem mais necessários, limpe os recursos implantados excluindo o grupo de recursos e seu repositório do GitHub.