A solução da Amazon Web Services (AWS) para o banco de dados relacional é chamada de Amazon Relational Database (RDS). RDS é um serviço da AWS que permite gerenciar bancos de dados relacionais na nuvem. O RDS fornece vários tipos de bancos de dados, mas aquele que você aprenderá a implantar hoje é o MSSQL.

Como muitos outros serviços da AWS, você pode gerenciar bancos de dados RDS de algumas maneiras diferentes, como por meio do AWS Management Console, ferramenta AWS CLI, qualquer número de SDKs ou com PowerShell. A escolha do melhor método é sua. (Se você estiver em uma equipe com gurus do PowerShell ou já tiver alguns scripts de automação da AWS escritos no PowerShell, um script do PowerShell pode fazer o trabalho bem feito.)

Neste artigo, você aprenderá a usar o PowerShell e o módulo AWS PowerShell para implantar uma instância AWS RDS em um piscar de olhos!

Pré-requisitos

Para seguir as etapas neste artigo, primeiro você deve verificar se atendeu a alguns pré-requisitos assumidos. Espero que você já tenha atendido a estes requisitos:

  1. Criou uma conta AWS
  2. Estão usando PowerShell Core (estou usando PowerShell 6.2.0.)
  3. Ter baixado e instalado o módulo AWS.Tools.RDS PowerShell (estou usando a v3.3.590).
  4. Autenticado em sua conta AWS, o usuário root ou um usuário IAM com direitos para criar uma instância RDS

Depois de confirmar que você atende a todos esses requisitos, vamos começar!

Decidindo que tipo de instância RDS implantar

Antes de começar a codificar, você deve descobrir que tipo de instância RDS criar. Para implantar uma instância RDS com PowerShell, você deve conhecer alguns atributos-chave:

  • Nome da instância
  • Engine (SQL Server, MariaDB, MySql e assim por diante)
  • Classe de instância que atribui o tipo de recurso em que o banco de dados do SQL Server será executado
  • Nome de usuário e senha mestre
  • Qual deve ser o tamanho do banco de dados em gigabytes

Este artigo explica como encontrar cada um desses atributos para criar uma instância RDS com PowerShell.

Encontrando as versões do motor disponíveis

Enquanto você cria uma instância MSSQL RDS usando este artigo, é essencial saber que você tem outras opções. Execute o Get-RDSDBEngineVersion comando e grupo por nome de mecanismo para ver uma lista de tipos de banco de dados disponíveis.

PS> Get-RDSDBEngineVersion | Group-Object -Property Engine
 
 Count Name Group
 ----- ---- -----
 11 aurora {Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amaz…
 11 aurora-mysql {Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amaz…
 11 aurora-postgresql {Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amaz…
 1 docdb {Amazon.RDS.Model.DBEngineVersion}
 19 mariadb {Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amaz…
 27 mysql {Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amaz…
 1 neptune {Amazon.RDS.Model.DBEngineVersion}
 42 oracle-ee {Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amaz…
 20 oracle-se {Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amaz…
 20 oracle-se1 {Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amaz…
 21 oracle-se2 {Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amaz…
 55 postgres {Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amaz…
 18 sqlserver-ee {Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amaz…
 19 sqlserver-ex {Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amaz…
 19 sqlserver-se {Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion, Amaz…
 19 sqlserver-web {Amazon.RDS.Model.DBEngineVersion, Amazon.RDS.Model.DBEngineVersion

Como você implantou uma instância MSSQL RDS, pesquise um pouco mais sobre essa versão para ver todas as versões disponíveis.

Get-RDSDBEngineVersion -Engine 'sqlserver-ex' | Format-Table -Property EngineVersion

Encontrando a classe de instância

Uma instância RDS precisa de uma classe de instância, que define o tipo de recursos alocados para executar a instância. Infelizmente, não existe nenhuma maneira de encontrar instâncias disponíveis com PowerShell. Em vez disso, você pode acessar a página Tipos de instância do Amazon RDS para revisar suas opções.

Criação da instância RDS

Agora, você deve ter o nome da instância RDS que deseja criar, o mecanismo, a classe da instância e o nome de usuário / senha para atribuir a ela. Agora é hora de criá-lo.

Para criar uma nova instância RDS com PowerShell, use o New-RDSDBInstance cmdlet. Este único cmdlet permite que você passe todos os parâmetros necessários para criar uma instância.

Abaixo, você pode ver um exemplo de uso do New-RDSDBInstance cmdlet para criar uma instância com:

  • Um nome de CloudSavvy
  • O mecanismo de banco de dados MSSQL (versão mais recente do SQL Express)
  • UMA db.t2.micro classe de instância
  • A sa usuário com uma senha de senha
  • 20 GB de tamanho
  • Uma interface que permite conexões pela Internet

No exemplo, a saída do comando está sendo atribuída a uma variável chamada $instance.

$parameters = @{
 DBInstanceIdentifier="ClouddSavvy"
 Engine="sqlserver-ex"
 DBInstanceClass="db.t2.micro"
 MasterUsername="sa"
 MasterUserPassword = 'password' ## Do not to include a forward slash, @ symbol, double quotes or spaces
 AllocatedStorage = 20 ## Gigabytes
 PubliclyAccessible = $true ## to connect over the Internet
 }
 $instance = New-RDSDBInstance @parameters

Quando o New-RDSDBInstance comando for executado, ele retorna o controle para o console do PowerShell antes que a instância seja criada. Para monitorar o processo de criação, você pode monitorar o DBInstanceStatus propriedade devolvida por Get-RDSDBInstance.

PS62> (Get-RDSDBInstance -DBInstanceIdentifier $instance.DBInstanceIdentifier).DBInstanceStatus
 creating

Usando um pouco de magia PowerShell com um while loop, você pode criar um código que esperará que a instância entre no available antes de liberar o controle.

No exemplo a seguir, o PowerShell verifica o status de available a cada 30 segundos. Assim que a instância entra nesse estado, ela libera o controle.

while ((Get-RDSDBInstance -DBInstanceIdentifier $instance.DBInstanceIdentifier).DBInstanceStatus -ne 'available') {
 Write-Host 'Waiting for instance to be created...'
 Start-Sleep -Seconds 30
 }

Depois que o PowerShell libera o controle, você pode verificar o AWS Management Console e confirmar se a instância RDS foi criada. Para fazer isso, você pode navegar até a seção de serviço RDS ou seguir este link, mas certifique-se de substituí-lo pelo nome da região com a qual está trabalhando:

https://console.aws.amazon.com/rds/home?region=#dbinstances:

Resumo

Seguindo um processo passo a passo, agora você sabe como implantar uma instância AWS RDS com PowerShell. E, usando o código discutido neste artigo, você pode usá-lo em scripts de automação maiores ou criar uma instância por meio do console do PowerShell conforme desejar.

Adicione ao Google Notícias