Início rápido: Usar o GitHub Actions para se conectar ao Banco de Dados do Azure para MySQL — Servidor Flexível

APLICA-SE A:Banco de Dados do Azure para MySQL – Servidor ÚnicoBanco 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.

  • Início rápido: Criar uma instância do Banco de Dados do Azure para MySQL — Servidor Flexível no portal do Azure

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:

Gerar as credenciais de implantação

az ad sp create-for-rbac --name "myML" --role contributor \
                            --scopes /subscriptions/<subscription-id>/resourceGroups/<group-name> \
                            --json-auth

  {
    "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.

Você usará a cadeia de conexão como um segredo do GitHub.

Configurar segredos do GitHub

Adicionar seu fluxo de trabalho

1. Acesse Ações para seu repositório do GitHub.

2. Selecione Configurar seu fluxo de trabalho por conta própria.

3. Exclua tudo depois da seção on: do seu arquivo de fluxo de trabalho. Por exemplo, o fluxo de trabalho restante pode ter a aparência a seguir.

   name: CI
   
   on:
   push:
       branches: [ main ]
   pull_request:
       branches: [ main ]
   

4. 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 GitHub AZURE_CREDENTIALS criado anteriormente.

   • Entidade de serviço
   • OpenID Connect

   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 }}
   

5. 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 chamado data.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'
   

6. 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.

   • Entidade de serviço
   • OpenID Connect

   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

1. Acesse Ações para seu repositório do GitHub.

2. 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.

Próximas etapas