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
Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/
. -
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.
-
Escolha Create custom engine version (Criar versão de mecanismo personalizada).
-
Para Engine type (Tipo de mecanismo), escolha Oracle.
-
Para Edition (Edição), escolha Oracle Enterprise Edition. Não há suporte para Oracle Enterprise Edition (Oracle RAC option).
-
Em Major version (Versão principal), escolha a versão principal do mecanismo.
-
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 é
. Você pode usar de 1 a 50 caracteres alfanuméricos, sublinhados, travessões e pontos. Por exemplo, é possível inserir o nomemajor-engine-version
.customized_string
19.my_cev1
.Opcionalmente, insira uma descrição para a CEV.
-
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/
. -
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..
-
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
. Certifique-se de fazer o escape das aspas duplas (“) no código JSON, prefixando-as com uma barra invertida (\).manifest_string
O exemplo a seguir mostra o
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.manifest_string
"{\"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
é 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ê executas3-bucket-name
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:
-
--description
my-cev-description
-
database-installation-files-s3-prefix
, em queprefix
é o nome da pasta que você especificou em Carregar seus arquivos de instalação no Amazon S3.prefix
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-namemy-custom-installation-files
\ --database-installation-files-s3-prefix123456789012/cev1
\ --kms-key-idmy-kms-key
\ --description "some text" \ --manifestmanifest_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
e incluirá detalhes sobre a falha. Por exemplo, o evento imprime arquivos ausentes.major-engine-version.cev_name
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.