Gerar ficheiros Bicep usando o GitHub Copilot para Azure

Há muitas maneiras de criar novos recursos no Azure. Os arquivos Bicep fornecem uma abordagem declarativa, modular e reutilizável para definir recursos do Azure. Os modelos Bicep oferecem melhor legibilidade, manutenção e integração nativa com o Azure Resource Manager (ARM) em comparação com modelos ARM baseados em JSON ou métodos de script imperativos como PowerShell e CLI do Azure. O GitHub Copilot para Azure pode ajudá-lo a criar arquivos Bicep.

Gerar arquivos Bicep

Começar a usar arquivos Bicep pode exigir algum aprendizado se você for novo na sintaxe, mas ferramentas como o GitHub Copilot for Azure podem ajudar.

Cenário de exemplo

Suponha que você queira uma maneira fácil de criar um processo repetível e automatizado para criar um contêiner de Blob e compartilhamento de arquivos. Você pode estar familiarizado com como criar um contêiner de Blob e compartilhamento de arquivos usando o portal do Azure, mas não sabe como usar arquivos Bicep para realizar a mesma tarefa.

Exemplo de prompt

Crie um novo bate-papo (Ctrl + L) e copie e cole o seguinte prompt no painel de bate-papo do GitHub Copilot.

Show me a Bicep file that creates an Azure Storage account with a blob container and a file share.

Resposta de exemplo

O GitHub Copilot para Azure gera um arquivo Bicep semelhante ao seguinte.

@description('Specifies the name of the Azure Storage account.')
param storageAccountName string

@description('Specifies the name of the blob container to create.')
param blobContainerName string

@description('Specifies the name of the file share to create.')
param fileShareName string

@description('Specifies the location in which the Azure Storage resources should be deployed.')
param location string = resourceGroup().location

resource sa 'Microsoft.Storage/storageAccounts@2023-01-01' = {
  name: storageAccountName
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  properties: {
    accessTier: 'Hot'
  }
}

resource blobServices 'Microsoft.Storage/storageAccounts/blobServices@2023-01-01' = {
  parent: sa
  name: 'default'
}

resource blobContainer 'Microsoft.Storage/storageAccounts/blobServices/containers@2023-01-01' = {
  parent: blobServices
  name: blobContainerName
  properties: {
    publicAccess: 'None'
  }
}

resource fileServices 'Microsoft.Storage/storageAccounts/fileServices@2023-01-01' = {
  parent: sa
  name: 'default'
}

resource fileShare 'Microsoft.Storage/storageAccounts/fileServices/shares@2023-01-01' = {
  parent: fileServices
  name: fileShareName
  properties: {
    shareQuota: 100 // Quota in MB
  }
}

Crie um novo arquivo main.bicep e, em seguida, copie a resposta do GitHub Copilot para Azure e cole no novo arquivo.

Ao usar a CLI do Azure para executar o arquivo Bicep, você pode definir os parâmetros declarados como storageAccountName, blobContainerNamee fileShareName.

Como alternativa, você pode editar o arquivo Bicep inicializando o storageAccountName param para o valor desejado.

param storageAccountName string = '<your-storage-account-name>'

Refinar a resposta

No entanto, se és novo em ficheiros Bicep, podes precisar de mais informações. Continue solicitando na mesma sessão de bate-papo para entender as próximas etapas.

Por exemplo, você pode perguntar onde esse arquivo Bicep deve ser criado em seu espaço de trabalho VS Code.

Where in my workspace should I create the Azure Bicep file, and what should I call it?

Ele pode responder sugerindo uma pasta e um nome de arquivo para seu novo arquivo Bicep. Por exemplo, infra/storageAccount.bicep.

Finalmente, se você não tiver certeza sobre como implantar o arquivo Bicep, você pode criar um prompt que solicita instruções.

How do I execute the Azure Bicep file?

Poderá receber uma resposta semelhante à seguinte.

To execute the Bicep file, you can use the Azure CLI with the following steps:

1. **Install Azure CLI and Bicep CLI**: Ensure you have the Azure CLI and Bicep CLI installed. You can install Bicep using the Azure CLI with the command:

   az bicep install


2. **Log in to Azure**: Use the Azure CLI to log in to your Azure account:

   az login


3. **Deploy the Bicep file**: Use the `az deployment group create` command to deploy the Bicep file to a resource group. Replace `<resource-group-name>` with your resource group name and `<location>` with your desired Azure region:
  
   az deployment group create --resource-group <resource-group-name> --template-file infra/storageAccount.bicep --parameters storageAccountName=<your-storage-account-name> containerName=<your-container-name> fileShareName=<your-file-share-name> location=<location>


This command will deploy the resources defined in your Bicep file to the specified resource group in Azure.

Ao seguir estas instruções, caso se encontre bloqueio ou enfrentar um problema, continue a fazer perguntas ao GitHub Copilot, criando prompts que incluam a palavra azure no painel de chat.

Conteúdo relacionado

• Visão geral do bíceps
• O que é o GitHub Copilot for Azure?
• Introdução ao GitHub Copilot para Azure