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. Em geral, criar um CEV demora cerca de duas horas.

Depois disso, você pode utilizar a CEV para criar uma instância do RDS Custom. Certifique-se de que o bucket do Amazon S3 que contém seus arquivos de instalação não esteja na mesma região da AWS que o CEV. Caso contrário, o processo de criação do CEV falhará.

Para 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. Para Engine type (Tipo de mecanismo), escolha Oracle.

  5. Para Edition (Edição), escolha Oracle Enterprise Edition. Não há suporte para Oracle Enterprise Edition (Oracle RAC option).

  6. Em Major version (Versão principal), escolha a versão principal do mecanismo.

  7. Em Version details (Detalhes da versão), digite um nome válido em Custom engine version name (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.my_cev1.

    Opcionalmente, insira uma descrição para a CEV.

  8. 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 Carregar seus arquivos de instalação no Amazon S3. Por exemplo, digite s3://my-custom-installation-files/806242271698/cev1/.

  9. Na seção RDS Custom encryption (Criptografia do RDS Custom), selecione Enter a key ARN (Insira 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 mais informações, consulte Verifique se você tem uma chave do AWS KMS de criptografia simétrica..

  10. 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 custom-oracle-ee

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

  • --kms-key-id

  • --manifest manifest_string

    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 Preparar o manifesto de CEV. 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\"]}"

  • --database-installation-files-s3-bucket-name s3-bucket-name, em que s3-bucket-name é o nome do bucket que você especificou em Carregar seus arquivos de instalação no Amazon S3. A região da AWS na qual você executa create-custom-db-engine-version deve estar na mesma região da AWS que o bucket.

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

O exemplo a seguir cria uma CEV chamada 19.my_cev1. 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 \
    --engine-version 19.my_cev1 \
    --database-installation-files-s3-bucket-name my-custom-installation-files \
    --database-installation-files-s3-prefix 123456789012/cev1 \
    --kms-key-id my-kms-key \
    --description "some text" \
    --manifest manifest_string

Para Windows:

aws rds create-custom-db-engine-version ^
    --engine custom-oracle-ee ^
    --engine-version 19.my_cev1 ^
    --database-installation-files-s3-bucket-name s3://my-custom-installation-files ^
    --database-installation-files-s3-prefix 123456789012/cev1 ^
    --kms-key-id my-kms-key ^
    --description "some text" ^
    --manifest manifest_string

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

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

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

"DBEngineVersions": [
    {
        "Engine": "custom-oracle-ee",
        "Status": "available",
        "DBParameterGroupFamily": "custom-oracle-ee-19",
        "DBEngineVersionArn": "arn:aws:rds:us-west-2:<my-account-id>:cev:custom-oracle-ee/19.my_cev1/0a123b45-6c78-901d-23e4-5678f901fg23",
        "MajorEngineVersion": "19",
        "SupportsReadReplica": false,
        "SupportsLogExportsToCloudwatchLogs": false,
        "EngineVersion": "19.my_cev1",
        "DatabaseInstallationFilesS3BucketName": "my-custom-installation-files",
        "DBEngineDescription": "Oracle Database server EE for RDS Custom",
        "SupportedFeatureNames": [],
        "KMSKeyId": "arn:aws:kms:us-east-2:<your-account-id>:key/<my-kms-key-id>",
        "SupportsGlobalDatabases": false,
        "SupportsParallelQuery": false,
        "DatabaseInstallationFilesS3Prefix": "123456789012/cev1",
        "DBEngineVersionDescription": "some text",
        "ValidUpgradeTarget": [],
        "CreateTime": "2021-06-23T20:00:34.782Z"
    }
]

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.