Criar uma conta de armazenamento Azure

Nenhum.

Para criar uma conta de armazenamento Azure usando o PowerShell, instale o módulo mais recente Azure Az PowerShell. Consulte Instale o módulo Azure PowerShell.

Você pode entrar no Azure e executar comandos CLI do Azure de uma das duas maneiras:

• Execute comandos da CLI de dentro do portal Azure, em Azure Cloud Shell.
• Instale a CLI e execute comandos da CLI localmente.

Usar Azure Cloud Shell

Azure Cloud Shell é um shell bash gratuito que você pode executar diretamente no portal do Azure. O CLI do Azure é pré-instalado e configurado para uso com sua conta. Selecione o botão Cloud Shell no menu na seção superior direita do portal Azure:

O botão inicia um shell interativo que você pode usar para executar as etapas descritas neste artigo de instruções:

Instalar o CLI do Azure localmente

Você também pode instalar e usar o CLI do Azure localmente. Se você planeja usar CLI do Azure localmente, instale a versão mais recente do CLI do Azure. Consulte Instale o CLI do Azure.

Nenhum.

Nenhum.

A CLI do Desenvolvedor Azure (azd) é uma ferramenta de linha de comando de software livre que simplifica o provisionamento e a implantação de recursos para Azure usando um sistema de modelo. azd está disponível para vários ambientes de desenvolvimento, incluindo as seguintes opções:

• Localmente por meio da CLI instalando o azd.
• ambientes GitHub Codespaces.
• O portal Azure usando Cloud Shell.

  Observação

  O azd template inclui um .devcontainer que já está azd instalado. Você pode ignorar a etapa de instalação se planeja usar um devcontainer local ou em um ambiente como Codespaces.

• Você precisa de uma conta Azure com uma assinatura ativa. Você pode criar uma conta gratuitamente.

• Instalar e configurar o Terraform

Entre no portal Azure.

Entre em sua assinatura Azure usando o comando Connect-AzAccount e siga as instruções na tela para autenticar.

Connect-AzAccount

Para iniciar Azure Cloud Shell, entre no Azure portal.

Para fazer logon na instalação local da CLI, execute o comando az sign-in :

az login

N/D

N/D

Se você planeja usar azd via Cloud Shell:

• Entre no portal Azure.

• Inicie Cloud Shell selecionando o ícone correspondente. azd está disponível automaticamente em Cloud Shell e autentica usando a conta usada para entrar no portal do Azure.

  

Para entrar em uma instalação local de azd ou no ambiente Codespaces, execute o comando azd auth sign-in :

    azd auth login

azd abre uma janela do navegador que você pode usar para entrar no Azure.

Authenticate Terraform para Azure

Para criar uma conta de armazenamento Azure usando o portal Azure, siga estas etapas:

1. No menu esquerdo do portal, selecione Contas de armazenamento para exibir uma lista das contas de armazenamento. Se você não vir o menu do portal, selecione o botão de menu para ative-o.

   

2. Na página Contas de armazenamento, selecione Criar.

   

A página Criar uma conta de armazenamento organiza as opções para sua nova conta de armazenamento em guias. A imagem seguinte mostra essas abas.

Guia Básico

Na guia Noções básicas, insira as informações essenciais para sua conta de armazenamento. Depois de concluir a guia Conceitos básicos, você pode optar por personalizar ainda mais sua nova conta de armazenamento definindo opções nas outras guias, ou selecionar Revisar + criar para aceitar as opções padrão e dar sequência na validação e criação da conta.

A tabela a seguir descreve os campos da guia Conceitos básicos.

Guia Avançado

Na guia Avançado, é possível definir opções adicionais e modificar as configurações padrão para sua nova conta de armazenamento. Algumas dessas opções podem ser configuradas após a criação da conta de armazenamento, enquanto outras exigem configuração no momento da criação.

A tabela a seguir descreve os campos da guia Avançado.

Guia Rede

Na guia Rede, é possível definir as configurações de conectividade de rede e as preferências de roteamento para a sua nova conta de armazenamento. Você também pode configurar essas opções depois de criar a conta de armazenamento.

A tabela a seguir descreve os campos da guia de Rede.

Guia Proteção de dados

Na guia Proteção de dados, você pode configurar opções de proteção de dados para dados de blob em sua nova conta de armazenamento. Você também pode configurar essas opções depois de criar a conta de armazenamento. Para obter uma visão geral das opções de proteção de dados em Armazenamento do Azure, consulte Data protection overview.

A tabela a seguir descreve os campos na guia Proteção de dados.

Aba Segurança

Na guia Segurança , você pode configurar opções relacionadas à segurança.

A tabela a seguir descreve os campos na guia Segurança .

Guia Criptografia

Na guia Criptografia , você pode configurar opções relacionadas à forma como seus dados são criptografados quando eles são persistidos na nuvem. Algumas dessas opções só podem ser configuradas quando você cria a conta de armazenamento.

A tabela a seguir descreve os campos na guia Criptografia .

Guia marcas

Na guia Tags, especifique marcas do Resource Manager para ajudar a organizar seus recursos do Azure. Para mais informações, consulte Recursos de marca, grupos de recursos e assinaturas para organização lógica.

Guia Examinar + criar

Quando você vai para a guia Review + create, Azure valida as configurações da conta de armazenamento escolhidas. Se a validação for aprovada, você poderá criar a conta de armazenamento.

Se a validação falhar, o portal indicará quais configurações você precisa modificar.

Para criar uma conta de armazenamento de uso geral V2 com o PowerShell, primeiro crie um novo grupo de recursos chamando o comando New-AzResourceGroup:

$resourceGroup = "<resource-group>"
$location = "<location>"
New-AzResourceGroup -Name $resourceGroup -Location $location

Se você não tiver certeza de qual região especificar para o -Location parâmetro, recupere uma lista de regiões com suporte para sua assinatura usando o comando Get-AzLocation :

Get-AzLocation | select Location

Em seguida, crie uma conta de armazenamento de uso geral V2 Standard com armazenamento com redundância geográfica com acesso de leitura (RA-GRS) usando o comando New-AzStorageAccount. Lembre-se de que o nome de sua conta de armazenamento deve ser exclusivo no Azure, portanto substitua o valor do espaço reservado entre colchetes pelo seu próprio valor exclusivo:

New-AzStorageAccount -ResourceGroupName $resourceGroup `
  -Name <account-name> `
  -Location $location `
  -SkuName Standard_RAGRS `
  -Kind StorageV2 `
  -AllowBlobPublicAccess $false `
  -MinimumTlsVersion TLS1_2

Para criar uma conta com pontos de extremidade de zona DNS do Azure (versão prévia), siga estas etapas:

1. Registre-se para a versão prévia conforme descrito em Pontos de extremidade da zona DNS do Azure (versão prévia).

2. Verifique se tem a versão mais recente do PowerShellGet instalado.

   Install-Module PowerShellGet -Repository PSGallery -Force
   

3. Feche e reabra o console do PowerShell.

4. Instale a versão 4.4.2-preview ou posterior do módulo Az.Storage PowerShell. Talvez seja necessário desinstalar outras versões do módulo do PowerShell. Para obter mais informações sobre como instalar Azure PowerShell, consulte Instalar Azure PowerShell com o PowerShellGet.

   Install-Module Az.Storage -Repository PsGallery -RequiredVersion 4.4.2-preview -AllowClobber -AllowPrerelease -Force
   

Em seguida, crie a conta, especificando AzureDnsZone para o parâmetro -DnsEndpointType. Depois que a conta for criada, você poderá ver os pontos de extremidade de serviço obtendo as propriedades e PrimaryEndpointsSecondaryEndpoints para a conta de armazenamento.

$rgName = "<resource-group>"
$accountName = "<storage-account>"

$account = New-AzStorageAccount -ResourceGroupName $rgName `
          -Name $accountName `
          -SkuName Standard_RAGRS `
          -Location <location> `
          -Kind StorageV2 `
          -AllowBlobPublicAccess $false `
          -MinimumTlsVersion TLS1_2 `
          -DnsEndpointType AzureDnsZone

$account.PrimaryEndpoints
$account.SecondaryEndpoints

Para habilitar um namespace hierárquico para a conta de armazenamento usar Azure Data Lake Storage, defina o parâmetro EnableHierarchicalNamespace como $True na chamada para o comando New-AzStorageAccount.

A tabela a seguir mostra os valores a usar para os parâmetros SkuName e Kind ao criar um tipo específico de conta de armazenamento com a configuração de redundância desejada.

Para criar uma conta de armazenamento v2 de uso geral com CLI do Azure, primeiro crie um novo grupo de recursos chamando o comando az group create.

az group create \
  --name storage-resource-group \
  --location eastus

Se você não tiver certeza de qual região especificar para o --location parâmetro, recupere uma lista de regiões com suporte para sua assinatura usando o comando az account list-locations .

az account list-locations \
  --query "[].{Region:name}" \
  --out table

Em seguida, crie uma conta de armazenamento de uso geral V2 Standard com o armazenamento com redundância geográfica com acesso de leitura usando o comando az storage account create. Lembre-se de que o nome de sua conta de armazenamento deve ser exclusivo no Azure, portanto substitua o valor do espaço reservado entre colchetes pelo seu próprio valor exclusivo:

az storage account create \
  --name <account-name> \
  --resource-group storage-resource-group \
  --location eastus \
  --sku Standard_RAGRS \
  --kind StorageV2 \
  --min-tls-version TLS1_2 \
  --allow-blob-public-access false

Para criar uma conta com os pontos de extremidade da zona do DNS do Azure (versão prévia), primeiro inscreva-se para a versão prévia, como descrito em pontos de extremidade da zona do DNS do Azure (versão prévia). Em seguida, instale a extensão de visualização para o CLI do Azure se ela ainda não estiver instalada:

az extension add --name storage-preview

Em seguida, crie a conta, especificando AzureDnsZone para o parâmetro --dns-endpoint-type. Depois que a conta for criada, você poderá ver os pontos de extremidade de serviço obtendo a propriedade PrimaryEndpoints da conta de armazenamento.

az storage account create \
    --name <account-name> \
    --resource-group <resource-group> \
    --location <location> \
    --min-tls-version TLS1_2 \
    --allow-blob-public-access false \
    --dns-endpoint-type AzureDnsZone

Depois que a conta for criada, você poderá retornar os pontos de extremidade de serviço obtendo as propriedades e primaryEndpointssecondaryEndpoints para a conta de armazenamento.

az storage account show \
    --resource-group <resource-group> \
    --name <account-name> \
    --query '[primaryEndpoints, secondaryEndpoints]'

Para habilitar um namespace hierárquico para a conta de armazenamento utilizar Azure Data Lake Storage, defina o parâmetro enable-hierarchical-namespace como true na chamada para o comando az storage account create. A criação de um namespace hierárquico requer CLI do Azure versão 2.0.79 ou posterior.

Você pode usar Azure PowerShell ou CLI do Azure para implantar um arquivo Bicep para criar uma conta de armazenamento. O arquivo Bicep usado neste artigo de instruções é um dos modelos de início rápido do Azure Resource Manager. Bicep atualmente não dá suporte à implantação de um arquivo remoto. Baixe e salve o arquivo Bicep no computador local e execute os scripts.

$resourceGroupName = Read-Host -Prompt "Enter the Resource Group name"
$location = Read-Host -Prompt "Enter the location (i.e. centralus)"

New-AzResourceGroup -Name $resourceGroupName -Location "$location"
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateFile "main.bicep"

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
echo "Enter the location (i.e. centralus):" &&
read location &&
az group create --name $resourceGroupName --location "$location" &&
az deployment group create --resource-group $resourceGroupName --template-file "main.bicep"

Para saber como modificar esse arquivo Bicep ou criar novos, consulte:

• Documentação do Azure Resource Manager.
• Referência de modelo da conta de armazenamento.
• Exemplos adicionais de modelo de conta de armazenamento .

Você pode usar Azure PowerShell ou CLI do Azure para implantar um modelo de Resource Manager para criar uma conta de armazenamento. O modelo usado neste artigo de instruções é Azure Resource Manager modelos de início rápido. Para executar os scripts, selecione Try it para abrir o Azure Cloud Shell. Para colar o script, clique com o botão direito do mouse no shell e, em seguida, selecione Colar.

$resourceGroupName = Read-Host -Prompt "Enter the Resource Group name"
$location = Read-Host -Prompt "Enter the location (i.e. centralus)"

New-AzResourceGroup -Name $resourceGroupName -Location "$location"
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateUri "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json"

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
echo "Enter the location (i.e. centralus):" &&
read location &&
az group create --name $resourceGroupName --location "$location" &&
az deployment group create --resource-group $resourceGroupName --template-uri "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json"

Para saber como modificar esse modelo ou criar novos, consulte:

• Documentação do Azure Resource Manager.
• Referência de modelo da conta de armazenamento.
• Exemplos adicionais de modelo de conta de armazenamento .

A CLI do Desenvolvedor do Azure (azd) foi desenvolvida com base em azd modelos. Esses modelos usam arquivos Bicep, configurações básicas e tarefas de automação para provisionar e implantar recursos para Azure. Você também pode visualizar o código-fonte do modelo no repositório criar uma conta de armazenamento quickstart.

Inicialize e execute o modelo para este início rápido usando as seguintes etapas:

1. Execute o azd init comando em um terminal local ou no CloudShell.

   azd init --template https://github.com/azure-samples/azd-create-storage-account
   

2. azd solicita um nome de ambiente, que determina a nomenclatura de recursos provisionados em Azure. Insira o nome azdstorage e pressione Enter.

   Uma captura de tela mostrando o comando de inicialização da CLI do Desenvolvedor Azure.

3. Em seguida, execute o azd up comando para iniciar o processo de provisionamento e implantação de modelo.

   azd up
   

4. Se você ainda não estiver autenticado para Azure, azd gerará uma mensagem instruindo você a entrar no Azure usando o comando azd auth login.

   azd auth login
   

5. Depois de autenticar, azd solicitará que você escolha o local do Azure para provisionar a conta de armazenamento a partir de uma lista de regiões. Selecione o local desejado na lista e pressione Enter.

6. azd também solicitará um tipo de conta de armazenamento. O tipo é um parâmetro personalizado que foi adicionado ao modelo azd para adicionar flexibilidade ao provisionamento da conta de armazenamento. Escolha Standard_LRS ou qualquer tipo que você gostaria e pressione Enter.

7. azd começa a provisionar a conta de armazenamento. A saída do comando fornece um link para a implantação em Azure e detalhes de status até que o comando seja concluído.

   

8. Quando o comando for concluído, selecione o link para abrir o portal Azure para o grupo de recursos provisionado e a conta de armazenamento.

   

O código de exemplo deste artigo está localizado no repositório do GitHub Azure Terraform. Você pode visualizar o arquivo de log que contém os resultados de teste das versões atuais e anteriores do Terraform. Para obter mais informações, consulte articles e código de exemplo mostrando como usar o Terraform para gerenciar Azure recursos.

1. Crie um diretório para testar e executar o código terraform de exemplo e torná-lo o diretório atual.

2. Crie um arquivo chamado providers.tf, depois insira o código a seguir:

   terraform {
     required_providers {
       azurerm = {
         source  = "hashicorp/azurerm"
         version = "~>4.0"
       }
       random = {
         source  = "hashicorp/random"
         version = "~>3.0"
       }
     }
   }
   
   provider "azurerm" {
     features {}
   }
   

3. Crie um arquivo chamado main.tf, depois insira o código a seguir:

   # Create Resource Group
   resource "random_pet" "rg_name" {
     prefix = var.resource_group_name_prefix
   }
   
   resource "azurerm_resource_group" "rg" {
     location = var.resource_group_location
     name     = random_pet.rg_name.id
   }
   
   # Random String for unique naming
   resource "random_string" "name" {
     length  = 8
     special = false
     upper   = false
     lower   = true
     numeric = false
   }
   
   # Create Storage Account
   resource "azurerm_storage_account" "sa" {
     name                     = "sa${random_string.name.result}"
     resource_group_name      = azurerm_resource_group.rg.name
     location                 = azurerm_resource_group.rg.location
     account_tier             = "Standard"
     account_replication_type = "RAGRS"
     account_kind             = "StorageV2"
     min_tls_version          = "TLS1_2"
     allow_nested_items_to_be_public = false
   }
   

4. Crie um arquivo chamado variables.tf, depois insira o código a seguir:

   variable "resource_group_location" {
     type        = string
     default     = "eastus"
     description = "Location of the resource group."
   }
   
   variable "resource_group_name_prefix" {
     type        = string
     default     = "rg"
     description = "Prefix of the resource group name that's combined with a random ID so name is unique in your Azure subscription."
   }
   

5. Crie um arquivo chamado outputs.tf, depois insira o código a seguir:

   output "resource_group_name" {
     value = azurerm_resource_group.rg.name
   }
   
   output "storage_account_name" {
     value = azurerm_storage_account.sa.name
   }
   

   Importante

   Se você estiver usando o provedor 4.x azurerm, deverá especificar explicitamente a ID da assinatura do Azure para autenticar no Azure antes de executar os comandos do Terraform.

   Uma maneira de especificar a ID da assinatura Azure sem colocá-la no bloco providers é especificar a ID da assinatura em uma variável de ambiente chamada ARM_SUBSCRIPTION_ID.

   Para obter mais informações, consulte a documentação de referência do provedor Azure.

6. Inicialize o Terraform.

   Execute terraform init para inicializar a implantação do Terraform. Esse comando baixa o provedor de Azure necessário para gerenciar seus recursos de Azure.

   terraform init -upgrade
   

   Pontos principais:

   • O parâmetro -upgrade atualiza os plug-ins do provedor necessários para a versão mais recente que esteja em conformidade com as restrições de versão da configuração.

7. Crie um plano de execução Terraform.

   Execute o comando terraform plan para criar um plano de execução.

   terraform plan -out main.tfplan
   

   Pontos principais:

   • O comando terraform plan cria um plano de execução, mas não o executa. Em vez disso, ele determina quais ações são necessárias para criar a configuração especificada em seus arquivos de configuração. Esse padrão permite verificar se o plano de execução corresponde às suas expectativas antes de fazer alterações nos recursos reais.
   • O parâmetro opcional -out permite que você especifique um arquivo de saída para o plano. Usar o parâmetro -out garante que o plano que você examinou seja exatamente o que é aplicado.

8. Aplicar um plano de execução do Terraform.

   Execute o comando terraform apply para aplicar o plano de execução à sua infraestrutura de nuvem.

   terraform apply main.tfplan
   

   Pontos principais:

   • O exemplo de comando do terraform apply pressupõe que você executou o terraform plan -out main.tfplan anteriormente.
   • Se você especificou um nome de arquivo diferente para o parâmetro -out, use esse mesmo nome de arquivo na chamada para terraform apply.
   • Se você não usou o parâmetro -out, chame terraform apply sem nenhum parâmetro.

1. Vá para a conta de armazenamento no Azure portal.
2. Selecione Excluir.

Para excluir a conta de armazenamento, use o comando Remove-AzStorageAccount:

Remove-AzStorageAccount -Name <storage-account> -ResourceGroupName <resource-group>

Para excluir a conta de armazenamento, use o comando az storage account delete:

az storage account delete --name <storage-account> --resource-group <resource-group>

Para excluir a conta de armazenamento, use Azure PowerShell ou CLI do Azure.

$storageResourceGroupName = Read-Host -Prompt "Enter the resource group name"
$storageAccountName = Read-Host -Prompt "Enter the storage account name"
Remove-AzStorageAccount -Name $storageAccountName -ResourceGroupName $storageResourceGroupName

echo "Enter the resource group name:" &&
read resourceGroupName &&
echo "Enter the storage account name:" &&
read storageAccountName &&
az storage account delete --name storageAccountName --resource-group resourceGroupName

Para excluir a conta de armazenamento, use Azure PowerShell ou CLI do Azure.

$storageResourceGroupName = Read-Host -Prompt "Enter the resource group name"
$storageAccountName = Read-Host -Prompt "Enter the storage account name"
Remove-AzStorageAccount -Name $storageAccountName -ResourceGroupName $storageResourceGroupName

echo "Enter the resource group name:" &&
read resourceGroupName &&
echo "Enter the storage account name:" &&
read storageAccountName &&
az storage account delete --name storageAccountName --resource-group resourceGroupName

Para excluir o grupo de recursos e a conta de armazenamento que azd criou, use o azd down comando:

azd down

Quando você não precisar mais dos recursos criados por meio do Terraform, execute as seguintes etapas:

1. Execute o comando terraform plan e especifique a flag destroy.

   terraform plan -destroy -out main.destroy.tfplan
   

   Pontos principais:

   • O comando terraform plan cria um plano de execução, mas não o executa. Em vez disso, ele determina quais ações são necessárias para criar a configuração especificada em seus arquivos de configuração. Esse padrão permite verificar se o plano de execução corresponde às suas expectativas antes de fazer alterações nos recursos reais.
   • O parâmetro opcional -out permite que você especifique um arquivo de saída para o plano. Usar o parâmetro -out garante que o plano que você examinou seja exatamente o que é aplicado.

2. Execute o comando terraform apply para aplicar o plano de execução.

   terraform apply main.destroy.tfplan