View a markdown version of this page

Conecte-se ao Amazon Aurora - AWS Estúdio de aplicativos
Etapa 1: criar e configurar os recursos do AuroraEtapa 2: Crie uma política e uma função do IAM com as permissões apropriadas do AuroraEtapa 3: criar o conector Aurora no App Studio

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Conecte-se ao Amazon Aurora

Para conectar o App Studio ao Aurora para permitir que os criadores acessem e usem os recursos do Aurora em aplicativos, você deve executar as seguintes etapas:

  1. Etapa 1: criar e configurar os recursos do Aurora

  2. Etapa 2: Crie uma política e uma função do IAM com as permissões apropriadas do Aurora

  3. Etapa 3: criar o conector Aurora no App Studio

O App Studio é compatível com as seguintes versões do Aurora:

  • Aurora MySQL sem servidor V1:5.72

  • Aurora PostgreSQL sem servidor V1:11.18, 13.9

  • Aurora MySQL Serverless V2:13.11 ou superior, 14.8 ou superior e 15.3 ou superior

  • Aurora PostgreSQL Serverless V2:13.11 ou superior, 14.8 ou superior e 15.3 ou superior

Etapa 1: criar e configurar os recursos do Aurora

Para usar bancos de dados do Aurora com o App Studio, primeiro você deve criá-los e configurá-los adequadamente. Há dois tipos de banco de dados do Aurora compatíveis com o App Studio: Aurora PostgreSQL e Aurora MySQL. Para comparar os tipos, consulte Qual é a diferença entre o MySQL e o PostgreSQL? . Escolha a guia apropriada e siga o procedimento para configurar o Aurora para uso com os aplicativos do App Studio.

Aurora PostgreSQL

Use o procedimento a seguir para criar e configurar um cluster de banco de dados Aurora PostgreSQL para ser usado com o App Studio.

Para configurar o Aurora para uso com o App Studio

  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. Selecione Criar banco de dados.

  3. Escolha Aurora (compatível com PostgreSQL).

  4. Em Versões disponíveis, escolha qualquer versão maior ou igual à versão 13.1114.8, 15.3 e.

  5. Em Configurações, insira um identificador de cluster de banco de dados.

  6. Em Configuração da instância, escolha Serverless v2 e escolha uma capacidade apropriada.

  7. Em Conectividade, selecione Ativar a API de dados do RDS.

  8. Em Autenticação de banco de dados, selecione Autenticação de banco de dados IAM.

  9. Em Configuração adicional, em Nome inicial do banco de dados, insira um nome de banco de dados inicial para seu banco de dados.

Aurora MySQL

Use o procedimento a seguir para criar e configurar um cluster de banco de dados Aurora MySQL para ser usado com o App Studio.

O Aurora MySQL não oferece suporte à criação a partir da interface do usuário para as versões compatíveis com Data API ou Serverless v1. Para criar um cluster do Aurora MySQL compatível com a API de dados, você deve usar o. AWS CLI

nota

Para usar bancos de dados Aurora MySQL com o App Studio, eles devem estar em uma nuvem privada virtual (VPC). Para obter mais informações, consulte Trabalhar com um cluster de banco de dados em uma VPC no Guia do usuário do Amazon Aurora.

Para configurar o Aurora MySQL para uso com o App Studio

  1. Se necessário, instale o AWS CLI seguindo as instruções em Instalar ou atualize para a versão mais recente do AWS CLI no Guia do AWS Command Line Interface usuário.

  2. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  3. Na navegação do lado esquerdo, escolha Grupos de sub-redes.

  4. Escolha Create DB Subnet Group (Criar grupo de sub-redes de banco de dados).

  5. Preencha as informações e crie o grupo subnet. Para obter mais informações sobre grupos de sub-redes e o uso de VPCs, consulte Trabalhar com um cluster de banco de dados em uma VPC no Guia do usuário do Amazon Aurora.

  6. Execute o seguinte AWS CLI comando:

    aws rds create-db-cluster --database-name db_name \
    --db-cluster-identifier db_cluster_identifier \
    --engine aurora-mysql \
    --engine-version 5.7.mysql_aurora.2.08.3 \
    --engine-mode serverless \
    --scaling-configuration MinCapacity=4,MaxCapacity=32,SecondsUntilAutoPause=1000,AutoPause=true \
    --master-username userName \
    --master-user-password userPass \
    --availability-zones us-west-2b us-west-2c \
    --db-subnet-group-name subnet-group-name

    Substitua os campos a seguir:

    • db_nameSubstitua pelo nome do banco de dados desejado.

    • db_cluster_identifierSubstitua pelo identificador de cluster de banco de dados desejado.

    • (Opcional) Substitua os números no scaling-configuration campo conforme desejado.

    • userNameSubstitua por um nome de usuário desejado.

    • userPassSubstitua por uma senha desejada.

    • Emavailability-zones, adicione as zonas de disponibilidade do grupo de sub-redes que você criou.

    • subnet-group-nameSubstitua pelo nome do grupo de sub-redes que você criou.

Etapa 2: Crie uma política e uma função do IAM com as permissões apropriadas do Aurora

Para usar os recursos do Aurora com o App Studio, os administradores precisam criar uma política do IAM e anexá-la a uma função do IAM usada para dar ao App Studio permissões para acessar os recursos configurados. A política e a função do IAM controlam o escopo dos dados que os criadores podem usar e quais operações podem ser chamadas com base nesses dados, como Criar, Ler, Atualizar ou Excluir.

Recomendamos criar pelo menos uma função do IAM por serviço e política.

Etapa 2a: criar uma política de IAM com as permissões apropriadas do Aurora

A política do IAM que você cria e usa com o App Studio deve conter somente as permissões mínimas necessárias nos recursos apropriados para que o aplicativo siga as melhores práticas de segurança.

Para criar uma política do IAM com as permissões apropriadas do Aurora

  1. Faça login no console do IAM com um usuário que tenha permissões para criar funções do IAM. Recomendamos usar o usuário administrativo criado emInscreva-se em um Conta da AWS.

  2. No painel de navegação do lado esquerdo, escolha Políticas.

  3. Selecione Criar política.

  4. Na seção Editor de políticas, escolha a opção JSON.

  5. Substitua o trecho existente pelo seguinte trecho, substituindo-o pelo número da AWS conta na qual 111122223333 os recursos do Amazon Redshift e do Aurora estão contidos.

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "BaselineAuroraForAppStudio",
            "Effect": "Allow",
            "Action": [
                "rds-data:ExecuteStatement",
                "secretsmanager:GetSecretValue"
            ],
            "Resource": [
                "arn:aws:rds:*:111122223333:cluster:*",
                "arn:aws:secretsmanager:*:111122223333:secret:rds*"
            ]
        }
    ]
}

  6. Escolha Próximo.

  7. Na página Revisar e criar, forneça um nome de política, como Aurora_AppStudio uma Descrição (opcional).

  8. Escolha Criar política para criar a política.

Etapa 2b: criar uma função do IAM para dar ao App Studio acesso aos recursos do Aurora

Agora, crie uma função do IAM que use a política que você criou anteriormente. O App Studio usará essa política para obter acesso aos recursos configurados do Aurora.

Para criar uma função do IAM para dar ao App Studio acesso aos recursos do Aurora

  1. Faça login no console do IAM com um usuário que tenha permissões para criar funções do IAM. Recomendamos usar o usuário administrativo criado emInscreva-se em um Conta da AWS.

  2. No painel de navegação do console, escolha Roles (Perfis) e, em seguida, clique em Create role (Criar perfil).

  3. Em Tipo de entidade confiável, escolha Política de confiança personalizada.

  4. Substitua a política padrão pela política a seguir para permitir que os aplicativos do App Studio assumam essa função em sua conta.

    Você deve substituir os seguintes espaços reservados na política. Os valores a serem usados podem ser encontrados no App Studio, na página de configurações da conta.

    • 111122223333Substitua pelo AWS número da conta usada para configurar a instância do App Studio, listado como ID da AWS conta nas configurações da conta na sua instância do App Studio.

    • 11111111-2222-3333-4444-555555555555Substitua pelo ID da instância do App Studio, listado como ID da instância nas configurações da conta na sua instância do App Studio.

    JSON
    { 
    "Version":"2012-10-17",
    "Statement": [
        { 
            "Effect": "Allow",
            "Principal": { 
                "AWS": "arn:aws:iam::111122223333:root"
            }, 
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                        "aws:PrincipalTag/IsAppStudioAccessRole": "true",
                        "sts:ExternalId": "11111111-2222-3333-4444-555555555555"
                }
            }
        } 
    ]
}

    Escolha Próximo.

  5. Em Adicionar permissões, pesquise e selecione a política que você criou anteriormente (Aurora_AppStudio). Escolher + ao lado de uma política expandirá a política para mostrar as permissões concedidas por ela e marcar a caixa de seleção seleciona a política.

    Escolha Próximo.

  6. Na página Nome, revisão e criação, forneça um nome e uma descrição da função.

  7. Na Etapa 3: Adicionar tags, escolha Adicionar nova tag para adicionar a tag a seguir para fornecer acesso ao App Studio:

    • Chave: IsAppStudioDataAccessRole

    • Valor: true

  8. Escolha Criar função e anote o nome de recurso da Amazon (ARN) gerado. Você precisará dele ao criar o conector Aurora no App Studio.

Etapa 3: criar o conector Aurora no App Studio

Agora que você tem seus recursos do Aurora, a política e a função do IAM configuradas, use essas informações para criar o conector no App Studio que os criadores podem usar para conectar seus aplicativos ao Aurora.

nota

Você precisa ter a função de administrador no App Studio para criar conectores.

Para criar um conector para o Aurora

  1. Navegue até o App Studio.

  2. No painel de navegação do lado esquerdo, escolha Conectores na seção Gerenciar. Você será direcionado para uma página exibindo uma lista de conectores existentes com alguns detalhes sobre cada um.

  3. Escolha + Criar conector.

  4. Escolha o conector Amazon Aurora.

  5. Configure seu conector preenchendo os seguintes campos:

    • Nome: insira um nome para seu conector Aurora.

    • Descrição: insira uma descrição para seu conector Aurora.

    • Função do IAM: insira o nome de recurso da Amazon (ARN) da função do IAM criada emEtapa 2b: criar uma função do IAM para dar ao App Studio acesso aos recursos do Aurora. Para obter mais informações sobre o IAM, consulte o Guia do usuário do IAM.

    • ARN secreto: insira o ARN secreto do cluster de banco de dados. Para obter informações sobre onde encontrar o ARN secreto, consulte Visualizar os detalhes sobre um segredo para um cluster de banco de dados no Guia do usuário do Amazon Aurora.

    • Região: escolha a AWS região onde seus recursos do Aurora estão localizados.

    • ARN do banco de dados: insira o ARN do cluster de banco de dados. O ARN pode ser encontrado na guia Configuração do cluster de banco de dados, semelhante ao ARN secreto.

    • Tipo de banco de dados: escolha o tipo de banco de dados, MySQL ou PostgreSQL, que corresponda ao tipo de banco de dados criado em. Etapa 1: criar e configurar os recursos do Aurora

    • Nome do banco de dados: insira o nome do banco de dados, que também pode ser encontrado na guia Configuração do cluster de banco de dados.

    • Tabelas disponíveis: selecione as tabelas que você deseja usar com o App Studio usando esse conector.

  6. Escolha Avançar para revisar ou definir os mapeamentos da entidade.

  7. Escolha Criar para criar o conector Aurora. O conector recém-criado aparecerá na lista de conectores.