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
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).
-
Em Opções de mecanismo, faça o seguinte:
-
Para Engine type (Tipo de mecanismo), escolha Oracle.
-
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 mecanismocustom-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.
-
Em Versão principal, selecione a versão principal do mecanismo.
-
-
Em Detalhes da versão, conclua o seguinte:
-
Insira um nome válido em 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.cdb_cev1
. -
(Opcional) Insira uma descrição para sua CEV.
-
-
Em Mídia de instalação, faça o seguinte:
-
(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 deImageID
.
Se você não inserir um ID de AMI, o RDS Custom usará a AMI mais recente disponível.
-
-
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/
. -
Em Manifesto de CEV, insira o manifesto JSON que você criou em Criar o manifesto de CEV.
-
-
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.
-
(Opcional) Selecione Adicionar nova tag para criar um par de chave/valor para sua CEV.
-
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
, em queengine-type
engine-type
écustom-oracle-ee-cdb
para um CDB oucustom-oracle-ee
para um não CDB. Você pode criar CDBs somente a partir de uma CEV criada comcustom-oracle-ee-cdb
. Você pode criar não CDBs somente a partir de uma CEV criada comcustom-oracle-ee
. -
--engine-version
major-engine-version
.customized_string
-
--kms-key-id
-
--manifest
oumanifest_string
--manifest file:
file_name
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 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.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\"]\"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
é 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 os3-bucket-name
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-prefix
, em queprefix
é o nome da pasta que você especificou em Etapa 3: Fazer upload de seus arquivos de instalação no Amazon S3.prefix
-
--image-id
, em queami-id
está um ID da AMI que deseja reutilizar. Para encontrar IDs válidos, execute o comandoami-id
describe-db-engine-versions
e, depois, pesquise a saída deImageID
. 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-version19.cdb_cev1
\ --database-installation-files-s3-bucket-nameus-east-1-123456789012-custom-installation-files
\ --database-installation-files-s3-prefix123456789012/cev1
\ --kms-key-idmy-kms-key
\ --description "test cev
" \ --manifestmanifest_string
\ --image-idami-012a345678901bcde
Para Windows:
aws rds create-custom-db-engine-version ^ --engine
custom-oracle-ee-cdb
^ --engine-version19.cdb_cev1
^ --database-installation-files-s3-bucket-nameus-east-1-123456789012-custom-installation-files
^ --database-installation-files-s3-prefix123456789012/cev1
^ --kms-key-idmy-kms-key
^ --description "test cev
" ^ --manifestmanifest_string
^ --image-idami-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
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.