Criar um CEV - Amazon Relational Database Service
Falha ao criar um CEV

Criar um CEV

É possível criar uma CEV usando o AWS Management Console ou a AWS CLI. Especifique a arquitetura multilocatário ou não multilocatário. Para obter mais informações, consulte Considerações sobre arquitetura multilocatário.

O bucket do Amazon S3 que contém seus arquivos de instalação não deve estar na mesma Região da AWS que a CEV. Caso contrário, o processo de criação do CEV falhará.

Em geral, criar um CEV demora cerca de duas horas. Depois que a CEV é criada, você pode usá-la para criar uma instância de banco de dados do RDS Custom. Para ter mais informações, consulte Criar uma instância de banco de dados do RDS Custom for Oracle.

Para criar um CEV

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

  2. No painel de navegação, escolha Custom engine versions (Versões de mecanismos personalizadas).

    A página Custom engine versions (Versões de mecanismo personalizadas) mostra todas as CEVs existentes. Se você não tiver criado uma CEV, a página estará vazia.

  3. Escolha Create custom engine version (Criar versão de mecanismo personalizada).

  4. Em Opções de mecanismo, faça o seguinte:

    1. Para Engine type (Tipo de mecanismo), escolha Oracle.

    2. Em Configurações de arquitetura, selecione Arquitetura multilocatária para criar uma CEV multilocatária, que usa o mecanismo custom-oracle-ee-cdb. Você pode criar um RDS Custom para Oracle CDB somente com uma CEV multilocatária. Se você não escolher essa opção, sua CEV não será CDB, que usa o mecanismo custom-oracle-ee.

      nota

      A arquitetura escolhida será uma característica permanente da CEV. Você não pode modificar sua CEV para usar uma arquitetura diferente posteriormente.

    3. Em Versão principal, selecione a versão principal do mecanismo.

  5. Em Detalhes da versão, conclua o seguinte:

    1. Insira um nome válido em Nome da versão de mecanismo personalizada.

      O formato do nome é major-engine-version.customized_string. Você pode usar de 1 a 50 caracteres alfanuméricos, sublinhados, travessões e pontos. Por exemplo, é possível inserir o nome 19.cdb_cev1.

    2. (Opcional) Insira uma descrição para sua CEV.

  6. Em Mídia de instalação, faça o seguinte:

    1. (Opcional) Para ID da AMI, insira uma AMI que você usou anteriormente para criar uma CEV. Para obter IDs de AMI usando uma das seguintes técnicas:

      • No console, selecione Versões personalizadas do mecanismo no painel de navegação esquerdo e escolha o nome de uma CEV. O ID da AMI usado pela CEV é exibido na guia Configuração.

      • Na AWS CLI, use o comando describe-db-engine-versions. Pesquise a saída de ImageID.

      Se você não inserir um ID de AMI, o RDS Custom usará a AMI mais recente disponível.

    2. Para S3 location of manifest files (Localização dos arquivos de manifesto no S3), insira o local do bucket do Amazon S3 que você especificou em Etapa 3: Fazer upload de seus arquivos de instalação no Amazon S3. Por exemplo, digite s3://my-custom-installation-files/806242271698/cev1/.

    3. Em Manifesto de CEV, insira o manifesto JSON que você criou em Criar o manifesto de CEV.

  7. Na seção Chave do KMS, selecione Inserir um ARN de chave para listar as chaves do AWS KMS disponíveis. Em seguida, selecione sua chave do KMS na lista.

    Uma chave do AWS KMS é necessária para o RDS Custom. Para ter mais informações, consulte Etapa 1: Criar ou reutilizar uma chave AWS KMS de criptografia simétrica.

  8. (Opcional) Selecione Adicionar nova tag para criar um par de chave/valor para sua CEV.

  9. Escolha Create custom engine version (Criar versão de mecanismo personalizada).

    Se o manifesto CEV tiver um formulário inválido, o console exibirá Error validating the CEV manifest (Erro ao validar o manifesto de CEV). Corrija os problemas e tente novamente.

A página Custom engine versions (Versões de mecanismo personalizadas) é exibida. Sua CEV é mostrada com o status Creating (Criando). O processo para criar o CEV demora aproximadamente duas horas.

Para criar uma CEV utilizando a AWS CLI, execute o comando create-custom-db-engine-version.

São necessárias as seguintes opções:

  • --engine engine-type, em que engine-type é custom-oracle-ee-cdb para um CDB ou custom-oracle-ee para um não CDB. Você pode criar CDBs somente a partir de uma CEV criada com custom-oracle-ee-cdb. Você pode criar não CDBs somente a partir de uma CEV criada com custom-oracle-ee.

  • --engine-version major-engine-version.customized_string

  • --kms-key-id

  • --manifest manifest_string ou --manifest file:file_name

    Caracteres de nova linha não são permitidos em manifest_string. Certifique-se de fazer o escape das aspas duplas (“) no código JSON, prefixando-as com uma barra invertida (\).

    O exemplo a seguir mostra o manifest_string para 19c de Etapa 5: Preparar o manifesto CEV. O exemplo define novos valores para a base Oracle, o Oracle Home e o ID e o nome do usuário e do grupo do UNIX/Linux. Se você copiar essa string, remova todos os caracteres de nova linha antes de colá-la no seu comando.

    "{\"mediaImportTemplateVersion\": \"2020-08-14\",\"databaseInstallationFileNames\": [\"V982063-01.zip\"],\"opatchFileNames\": [\"p6880880_190000_Linux-x86-64.zip\"],\"psuRuPatchFileNames\": [\"p32126828_190000_Linux-x86-64.zip\"],\"otherPatchFileNames\": [\"p29213893_1910000DBRU_Generic.zip\",\"p29782284_1910000DBRU_Generic.zip\",\"p28730253_190000_Linux-x86-64.zip\",\"p29374604_1910000DBRU_Linux-x86-64.zip\",\"p28852325_190000_Linux-x86-64.zip\",\"p29997937_190000_Linux-x86-64.zip\",\"p31335037_190000_Linux-x86-64.zip\",\"p31335142_190000_Generic.zip\"]\"installationParameters\":{ \"unixGroupName\":\"dba\", \ \"unixUname\":\"oracle\", \ \"oracleHome\":\"/home/oracle/oracle.19.0.0.0.ru-2020-04.rur-2020-04.r1.EE.1\", \ \"oracleBase\":\"/home/oracle/\"}}"

  • --database-installation-files-s3-bucket-name s3-bucket-name, em que s3-bucket-name é o nome do bucket que você especificou em Etapa 3: Fazer upload de seus arquivos de instalação no Amazon S3. A Região da AWS na qual você executa o create-custom-db-engine-version deve ser a mesma de seu bucket do Amazon S3.

Também é possível especificar as seguintes opções:

  • --description my-cev-description

  • --database-installation-files-s3-prefixprefix, em que prefix é o nome da pasta que você especificou em Etapa 3: Fazer upload de seus arquivos de instalação no Amazon S3.

  • --image-id ami-id, em que ami-id está um ID da AMI que deseja reutilizar. Para encontrar IDs válidos, execute o comando describe-db-engine-versions e, depois, pesquise a saída de ImageID. Por padrão, o RDS Custom para Oracle usa a AMI mais recente disponível.

O exemplo a seguir cria uma CEV multilocatária chamada 19.cdb_cev1. O exemplo reutiliza uma AMI existente em vez de usar a AMI mais recente disponível. Certifique-se de que o nome do seu CEV comece com o número da versão principal do mecanismo.

Para Linux, macOS ou Unix:

aws rds create-custom-db-engine-version \
    --engine custom-oracle-ee-cdb \
    --engine-version 19.cdb_cev1 \
    --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files \
    --database-installation-files-s3-prefix 123456789012/cev1 \
    --kms-key-id my-kms-key \
    --description "test cev" \
    --manifest manifest_string \
    --image-id ami-012a345678901bcde

Para Windows:

aws rds create-custom-db-engine-version ^
    --engine custom-oracle-ee-cdb ^
    --engine-version 19.cdb_cev1 ^
    --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files ^
    --database-installation-files-s3-prefix 123456789012/cev1 ^
    --kms-key-id my-kms-key ^
    --description "test cev" ^
    --manifest manifest_string ^
    --image-id ami-012a345678901bcde

Obtenha detalhes sobre a sua CEV com o comando describe-db-engine-versions.

aws rds describe-db-engine-versions \
    --engine custom-oracle-ee-cdb \
    --include-all

A saída de exemplo parcial a seguir mostra o mecanismo, os grupos de parâmetros, o manifesto e outras informações.

{
    "DBEngineVersions": [
        {
            "Engine": "custom-oracle-ee-cdb",
            "EngineVersion": "19.cdb_cev1",
            "DBParameterGroupFamily": "custom-oracle-ee-cdb-19",
            "DBEngineDescription": "Containerized Database for Oracle Custom EE",
            "DBEngineVersionDescription": "test cev",
            "Image": {
                "ImageId": "ami-012a345678901bcde",
                "Status": "active"
            },
            "ValidUpgradeTarget": [],
            "SupportsLogExportsToCloudwatchLogs": false,
            "SupportsReadReplica": true,
            "SupportedFeatureNames": [],
            "Status": "available",
            "SupportsParallelQuery": false,
            "SupportsGlobalDatabases": false,
            "MajorEngineVersion": "19",
            "DatabaseInstallationFilesS3BucketName": "us-east-1-123456789012-custom-installation-files",
            "DatabaseInstallationFilesS3Prefix": "123456789012/cev1",
            "DBEngineVersionArn": "arn:aws:rds:us-east-1:123456789012:cev:custom-oracle-ee-cdb/19.cdb_cev1/abcd12e3-4f5g-67h8-i9j0-k1234l56m789",
            "KMSKeyId": "arn:aws:kms:us-east-1:732027699161:key/1ab2345c-6d78-9ef0-1gh2-3456i7j89k01",
            "CreateTime": "2023-03-07T19:47:58.131000+00:00",
            "TagList": [],
            "SupportsBabelfish": false,
...

Falha ao criar um CEV

Se o processo de criação do CEV falhar, o RDS Custom emitirá RDS-EVENT-0198 com a mensagem Creation failed for custom engine version major-engine-version.cev_name e incluirá detalhes sobre a falha. Por exemplo, o evento imprime arquivos ausentes.

Não é possível modificar uma CEV com falha. Você pode apenas excluí-la e tentar novamente criar uma CEV depois de corrigir as causas da falha. Para obter informações sobre como solucionar os motivos da falha na criação da CEV, consulte Solucionar problemas com a criação de uma versão de mecanismo personalizado para o RDS Custom for Oracle.