Création d'une CEV - Amazon Relational Database Service
Échec de la création d'une CEV

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création d'une CEV

Vous pouvez créer une CEV à l'aide de la AWS Management Console ou de la AWS CLI. Spécifiez l'architecture multilocataire ou non multilocataire. Pour plus d’informations, consultez Considérations relatives à l'architecture multilocataire.

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

Note

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

Prenez note des exigences et limitations suivantes pour créer une CEV :

  • Le compartiment Amazon S3 contenant vos fichiers d’installation doit se trouver dans la même Région AWS que votre CEV. Sinon, le processus de création échoue.

  • Le nom de la CEV doit être au format major-engine-version.customized_string, comme dans 19.cdb_cev1.

  • Le nom de la CEV doit contenir entre 1 et 50 caractères alphanumériques, des traits de soulignement, des tirets ou des points.

  • Le nom de la CEV ne peut pas contenir de points consécutifs, comme dans 19..cdb_cev1.

Pour créer une CEV

  1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon RDS à l’adresse https://console.aws.amazon.com/rds/.

  2. Dans le panneau de navigation, choisissez Custom engine versions (Versions de moteur personnalisées).

    La page Custom engine versions (Versions de moteur personnalisées) affiche toutes les CEV qui existent actuellement. Si vous n'avez pas créé de CEV, la page est vide.

  3. Choisissez Create custom engine version (Créer une version de moteur personnalisée).

  4. Dans Options de moteur, procédez comme suit :

    1. Pour Engine type (Type de moteur), choisissez Oracle.

    2. Pour Paramètres d’architecture, vous pouvez choisir Architecture à locataires multiples pour créer une CEV à locataires multiples Oracle qui utilise le moteur de base de données custom-oracle-ee-cdb ou custom-oracle-se2-cdb. Vous pouvez créer une base de données CDB RDS Custom for Oracle avec une version CEV multi-locataire. Si vous ne choisissez pas cette option, votre CEV est une base de données non CDB, qui utilise le moteur custom-oracle-ee ou custom-oracle-se2.

      Note

      L'architecture que vous choisissez est une caractéristique permanente de votre version CEV. Vous ne pouvez pas modifier votre CEV pour utiliser une architecture différente 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 manifeste JSON indiquant les fichiers binaires de la base de données.

      • Créer CEV à partir de la source — Dans Spécifiez le CEV que vous souhaitez copier, choisissez un CEV existant à utiliser comme CEV source. 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.

  5. 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) Saisissez une description pour votre CEV.

  6. Dans Média d'installation, procédez comme suit :

    1. (Facultatif) Dans le champ ID d'AMI, laissez le champ vide pour utiliser la dernière AMI fournie par le service ou saisissez une AMI que vous avez utilisée précédemment pour créer un CEV. Pour obtenir des ID d'AMI valides, utilisez l'une des techniques suivantes :

      • Dans la console, choisissez Versions de moteur personnalisées dans le panneau de navigation de gauche, puis choisissez le nom d’une CEV. L'ID AMI utilisé par la CEV apparaît dans l'onglet Configuration.

      • Dans l'AWS CLI, utilisez la commande describe-db-engine-versions. 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

      La Région AWS dans laquelle vous créer le CEV doit se trouver dans la même région que le compartiment S3.

    3. (Créer un nouveau CEV uniquement) Pour Manifeste CEV, saisissez le manifeste JSON que vous avez créé dans Création du manifeste CEV.

  7. Dans la section Clé KMS, sélectionnez Entrez un ARN de clé pour répertorier les clés AWS KMS disponibles. Sélectionnez ensuite votre clé KMS dans la liste.

    Une clé AWS KMS est nécessaire pour RDS Custom. Pour plus d’informations, consultez Étape 1 : création ou réutilisation d’une clé de chiffrement symétrique AWS KMS.

  8. (Facultatif) Choisissez Ajouter une nouvelle balise pour créer une paire clé-valeur pour votre CEV.

  9. Choisissez Create custom engine version (Créer une version de moteur personnalisée).

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

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

Pour créer une CEV à l'aide de la AWS CLI, exécutez la commande create custom-db-engine version.

Les options suivantes sont requises :

  • --engine – Spécifier le type de moteur. Pour une CDB, spécifiez custom-oracle-ee-cdb ou custom-oracle-se2-cdb. Pour un objet autre qu’une CDB, spécifiez custom-oracle-ee ou custom-oracle-se2. Vous pouvez créer des CDB uniquement à partir d’une CEV créée avec custom-oracle-ee-cdb ou custom-oracle-se2-cdb. Vous pouvez créer des bases de données non CDB uniquement à partir d’une CEV créée avec custom-oracle-ee ou custom-oracle-se2.

  • --engine-version : spécifiez la version du moteur. Le format est version-majeure-moteur.chaîne_personnalisée. Le nom de la CEV doit contenir entre 1 et 50 caractères alphanumériques, des traits de soulignement, des tirets ou des points. Le nom de la CEV ne peut pas contenir de points consécutifs, comme dans 19..cdb_cev1.

  • --kms-key-id : spécifiez une 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'échapper les guillemets doubles (") dans le code JSON en les faisant précéder d'une barre oblique inversée (\).

    L'exemple suivant illustre la manifest_json_string pour 19c à partir de Étape 5 : Préparer le manifeste CEV. L'exemple définit de nouvelles valeurs pour la base Oracle, le répertoire de base de base de données Oracle, 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 saut de 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. La Région AWS dans laquelle vous exécutez create-custom-db-engine-version doit être dans la même région que votre compartiment Amazon S3.

Vous pouvez également spécifier les options suivantes :

  • --description : spécifiez une description de votre CEV.

  • --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 ID d'AMI que vous souhaitez réutiliser. Pour trouver des ID valides, exécutez la commande describe-db-engine-versions, puis recherchez la sortie pour ImageID. Par défaut, RDS Custom for Oracle utilise l'AMI disponible la plus récente.

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

Pour 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

Pour 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 commande describe-db-engine-versions.

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,
...

Échec de la création d'une CEV

Si la création d'une CEV échoue, RDS Custom émet RDS-EVENT-0198 avec le message Creation failed for custom engine version major-engine-version.cev_name et ajoute des détails sur l'échec. Par exemple, l'événement imprime les fichiers manquants.

Vous ne pouvez pas modifier une CEV qui a échoué. Vous pouvez seulement la supprimer, puis réessayer de créer une CEV après avoir corrigé les causes de l'échec. Pour plus d'informations concernant le dépannage des raisons de l'échec de création de CEV, voir Résolution des problèmes liés à la création d'une version de moteur personnalisée pour RDS Custom for Oracle.