Création d’un CEV

Vous pouvez créer un CEV en utilisant le AWS Management Console ou le AWS CLI. Spécifiez l'architecture multilocataire ou non multilocataire. Pour de plus amples informations, veuillez consulter Considérations relatives à l'architecture multilocataire.

En général, la création d'un CEV prend environ deux heures. Après avoir créé leCEV, vous pouvez l'utiliser pour créer ou mettre à niveau une instance de base de données RDS personnalisée. Pour plus d’informations, consultez Création d'une instance de base de données RDS personnalisée pour Oracle et Mise à niveau d'une instance de base de données RDS personnalisée pour Oracle.

Note

Si votre instance de base de données utilise actuellement Oracle Linux 7.9, créez-en une nouvelle CEV qui utilise la dernière versionAMI, qui utilise Oracle Linux 8. Modifiez ensuite votre instance pour utiliser la nouvelleCEV.

Notez les exigences et limites suivantes pour créer un CEV :

Le compartiment Amazon S3 contenant vos fichiers d'installation doit se trouver dans le même compartiment Région AWS que le vôtreCEV. Dans le cas contraire, le processus de création échoue.
Le CEV nom doit être au formatmajor-engine-version.customized_string, comme dans19.cdb_cev1.
Le CEV nom doit contenir de 1 à 50 caractères alphanumériques, des traits de soulignement, des tirets ou des points.
Le CEV nom ne peut pas contenir de points consécutifs, comme dans19..cdb_cev1.

Pour créer une CEV

Connectez-vous à la RDS console Amazon AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/rds/.
Dans le panneau de navigation, choisissez Custom engine versions (Versions de moteur personnalisées).

La page Versions personnalisées du moteur affiche tout CEVs ce qui existe actuellement. Si vous n'en avez pas crééCEVs, la page est vide.
Choisissez Create custom engine version (Créer une version de moteur personnalisée).
Dans Options de moteur, procédez comme suit :
1. Pour Engine type (Type de moteur), choisissez Oracle.
2. Pour les paramètres d'architecture, choisissez éventuellement Architecture multitenant pour créer un multitenant OracleCEV, qui utilise le moteur custom-oracle-ee-cdb de base de données ou. custom-oracle-se2-cdb Vous pouvez créer un RDS Custom pour Oracle CDB avec un multitenant CEV uniquement. Si vous ne choisissez pas cette option, CEV il s'agit d'un non-CDB, qui utilise le moteur custom-oracle-ee oucustom-oracle-se2.
  
  Note
  L'architecture que vous choisissez est une caractéristique permanente de votreCEV. Vous ne pourrez pas modifier votre architecture CEV pour utiliser une autre architecture ultérieurement.
3. Choisissez l'une des options suivantes :
  - Créer un nouveau CEV — Créez un CEV à partir de zéro. Dans ce cas, vous devez spécifier un JSON manifeste spécifiant les fichiers binaires de base de données.
  - Créer CEV à partir de la source : dans Spécifiez CEV ce que vous souhaitez copier, choisissez un existant CEV à utiliser comme sourceCEV. Dans ce cas, vous pouvez spécifier une nouvelle Amazon Machine Image (AMI), mais vous ne pouvez pas spécifier de fichiers binaires de base de données différents.
4. Pour Version du moteur, choisissez la version majeure du moteur.
Dans Détails de la version, procédez comme suit :
1. Saisissez un nom valide dans Nom de version de moteur personnalisée. Par exemple, vous pouvez saisir le nom 19.cdb_cev1.
2. (Facultatif) Entrez une description pour votreCEV.
Dans Média d'installation, procédez comme suit :
1. (Facultatif) Pour AMIID, laissez le champ vide pour utiliser le dernier service fourni ou AMI entrez un numéro AMI que vous avez utilisé précédemment pour créer un. CEV Pour obtenir un résultat valide AMIIDs, utilisez l'une des techniques suivantes :
  - Dans la console, choisissez Versions personnalisées du moteur dans le volet de navigation de gauche, puis choisissez le nom d'unCEV. L'AMIID utilisé par le CEV apparaît dans l'onglet Configuration.
  - Dans le AWS CLI, utilisez la describe-db-engine-versions commande. Recherchez la sortie pour ImageID.
2. Pour S3 location of manifest files (Emplacement S3 des fichiers manifestes), saisissez l'emplacement du compartiment Amazon S3 que vous avez spécifié dans Étape 3 : Charger vos fichiers d'installation dans Amazon S3. Par exemple, saisissez s3://my-custom-installation-files/123456789012/cev1/.
  
  Note
  Le compartiment Région AWS dans lequel vous le créez CEV doit se trouver dans la même région que le compartiment S3.
3. (Créer un nouveau CEV uniquement) Pour le CEVmanifeste, entrez le JSON manifeste dans lequel vous l'avez crééCréation du CEV manifeste.
Dans la section KMSclé, sélectionnez Entrer une clé ARN pour répertorier les AWS KMS clés disponibles. Sélectionnez ensuite votre KMS clé dans la liste.

Une AWS KMS clé est requise pour RDS Custom. Pour de plus amples informations, veuillez consulter Étape 1 : Créer ou réutiliser une clé de chiffrement symétrique AWS KMS.
(Facultatif) Choisissez Ajouter une nouvelle balise pour créer une paire clé-valeur pour votre. CEV
Choisissez Create custom engine version (Créer une version de moteur personnalisée).

Si le format du JSON manifeste n'est pas valide, la console affiche une erreur lors de la validation du CEV manifeste. Résolvez les problèmes et réessayez.

La page Custom engine versions (Versions de moteur personnalisées) s'affiche. Votre CEV est affiché avec le statut Création. Le processus de création d'un CEV prend environ deux heures.

Pour créer un CEV en utilisant le AWS CLI, exécutez la commande create-custom-db-engine-version.

Les options suivantes sont requises :

--engine— Spécifiez le type de moteur. Pour unCDB, spécifiez custom-oracle-ee-cdb soitcustom-oracle-se2-cdb. Pour une valeur non-CDB, spécifiez l'un custom-oracle-ee ou l'autrecustom-oracle-se2. Vous ne pouvez créer CDBs qu'à partir d'un CEV fichier créé avec custom-oracle-ee-cdb oucustom-oracle-se2-cdb. Vous pouvez créer non CDBs seulement à partir d'un CEV objet créé avec custom-oracle-ee oucustom-oracle-se2.
--engine-version : spécifiez la version du moteur. Le format estmajor-engine-version. customized_string. Le CEV nom doit contenir de 1 à 50 caractères alphanumériques, des traits de soulignement, des tirets ou des points. Le CEV nom ne peut pas contenir de points consécutifs, comme dans19..cdb_cev1.
--kms-key-id— Spécifiez un AWS KMS key.
--manifest : spécifiez manifest_json_string ou --manifest file:file_name. Les caractères de saut de ligne ne sont pas autorisés dans manifest_json_string. Assurez-vous d'éviter les guillemets («) dans le JSON code en les préfixant par une barre oblique inverse (\).

L'exemple suivant illustre la manifest_json_string pour 19c à partir de Étape 5 : Préparation du CEV manifeste. L'exemple définit de nouvelles valeurs pour la base Oracle, le répertoire d'origine Oracle Home, ainsi que l'ID et le nom de l'utilisateur et du groupe UNIX /Linux. Si vous copiez cette chaîne, supprimez tous les caractères de nouvelle ligne avant de la coller dans votre commande.

"{\"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 : spécifiez le même nom de compartiment que celui que vous avez indiqué dans Étape 3 : Charger vos fichiers d'installation dans Amazon S3. Le compartiment Région AWS dans lequel vous exécutez create-custom-db-engine-version doit appartenir à la même région que votre compartiment Amazon S3.

Vous pouvez également spécifier les options suivantes :

--description— Spécifiez une description de votreCEV.
--database-installation-files-s3-prefix : spécifiez le nom de dossier que celui que vous avez indiqué dans Étape 3 : Charger vos fichiers d'installation dans Amazon S3.
--image-id— Spécifiez un AMI identifiant que vous souhaitez réutiliser. Pour trouver une IDs valeur valide, exécutez la describe-db-engine-versions commande, puis recherchez le résultat pourImageID. Par défaut, RDS Custom for Oracle utilise la version la plus récente disponibleAMI.

L'exemple suivant crée un multitenant Oracle CEV nommé19.cdb_cev1. L'exemple réutilise une version existante AMI au lieu d'utiliser la dernière version disponibleAMI. Assurez-vous que le nom de votre moteur CEV commence par le numéro de version principal du moteur.

Dans Linux, macOS, ou Unix:


aws rds create-custom-db-engine-version \
    --engine custom-oracle-se2-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

Dans Windows:


aws rds create-custom-db-engine-version ^
    --engine custom-oracle-se2-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

Obtenez des détails sur votre CEV en utilisant la describe-db-engine-versions commande.


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

L'exemple de sortie partielle suivant affiche le moteur, les groupes de paramètres, le manifeste et d'autres informations.


{
    "DBEngineVersions": [
        {
            "Engine": "custom-oracle-se2-cdb",
            "EngineVersion": "19.cdb_cev1",
            "DBParameterGroupFamily": "custom-oracle-se2-cdb-19",
            "DBEngineDescription": "Containerized Database for Oracle Custom SE2",
            "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-se2-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,
...

Impossible de créer un CEV

Si le processus de création d'un CEV échoue, RDS Custom émet un problème RDS-EVENT-0198 avec le message Creation failed for custom engine version major-engine-version.cev_name et inclut des informations sur l'échec. Par exemple, l'événement imprime les fichiers manquants.

Vous ne pouvez pas modifier un échecCEV. Vous ne pouvez que le supprimer, puis réessayer d'en créer un CEV après avoir corrigé les causes de l'échec. Pour plus d'informations sur la résolution des problèmes à l'origine de l'échec de CEV création, consultezRésolution des problèmes liés à la création de versions de moteur RDS personnalisées pour Custom for Oracle.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Préparation à la création d'un CEV

Modification de l'état de la CEV