# Faire tourner Oracle Database Server dans un container Docker > Apprenez à faire tourner Oracle Database Server dans un container Docker. Ce guide pas à pas couvre la mise en place de l'image, l'acceptation de la licence, la génération du token et l'accès à la base de données. ---  **TL;DR** Ce guide complet vous accompagne pas à pas pour faire tourner un serveur Oracle Enterprise Database dans un container Docker. Il couvre tout le processus : création d'un compte Oracle, authentification pour récupérer l'image officielle, déploiement du container avec du stockage persistant et des scripts de démarrage personnalisés. Vous découvrirez les concepts clés de l'architecture multi-tenant d'Oracle (CDB vs PDB) et comment vous connecter à votre base et l'administrer avec des outils comme `sqlplus`, Oracle SQL Developer et l'interface web Oracle Enterprise Manager. Au boulot, j'ai dû créer une base de données Oracle Enterprise en local pour pouvoir écrire des scripts dans différents langages et montrer [comment se connecter à Oracle avec, par exemple, .Net, NodeJS, Python ou PHP](/blog/oracle-dotnet-nodejs-php-python). L'idée a donc tout de suite été de vérifier s'il existait une image officielle. Elle existe mais, zut, ce n'est pas aussi simple que pour PostgreSQL, MySQL ou [MS SQL Server](/blog/docker-mssql-server). Dans cet article, qui est une mise au propre de mes notes, nous allons installer Oracle Enterprise en local dans un container, créer une base avec des données d'exemple et accéder à cette base de plusieurs façons. C'est un guide pas à pas pour faciliter la vie de ceux qui doivent faire la même chose — moi, par exemple, dans quelques mois, quand j'aurai tout oublié. Ça prend un moment (Oracle est lent à s'initialiser), mais voici où nous allons : un container Oracle qui tourne, prêt à être interrogé.   Construisons tout ça, en commençant par l'image elle-même. ## Télécharger une image Docker pour OracleDB {#download-a-docker-image-for-oracledb} Oui, il existe bien une image Docker appelée `container-registry.oracle.com/database/enterprise:latest` mais, avant de pouvoir la télécharger, il faudra faire quelques choses : 1. Créer un compte gratuit sur oracle.com 2. Générer un token 3. Accepter les termes de la licence 4. Configurer votre environnement Docker local pour utiliser ce token Si vous sautez une étape et essayez de télécharger l'image directement, vous obtiendrez cette erreur : ```bash $ docker pull container-registry.oracle.com/database/enterprise:latest Error response from daemon: Head "https://container-registry.oracle.com/v2/database/enterprise/manifests/21.3.0.0": unauthorized: Auth failed. ``` ### Création d'un compte gratuit sur oracle.com {#creation-of-a-free-account-on-oraclecom} Rendez-vous sur et créez un utilisateur en cliquant sur le bouton / lien `Sign In` en haut à droite. > Screenshot — https\://container-registry.oracle.com/ords/ocr/ba/database/enterprise > > Assurez-vous d'être connecté > Screenshot — https\://container-registry.oracle.com/ords/ocr/ba/database/enterprise > > Page de connexion Oracle ### Générer un token {#generate-a-token} Une fois votre utilisateur validé (après réception d'un email), retournez sur le site , connectez-vous, cliquez sur votre profil puis choisissez `Auth Token`. > Screenshot — https\://container-registry.oracle.com/ords/ocr/ba/database/enterprise > > Création de votre Auth Token Cliquez sur le bouton `Generate Secret Key` et copiez votre **SSO Username** et votre **Secret Key** quelque part (dans votre gestionnaire de mots de passe par exemple). ### Accepter les termes de la licence {#accept-license-terms} Rendez-vous sur et cherchez `enterprise` dans la colonne `Repository`. > Screenshot — https\://container-registry.oracle.com/ords/ocr/ba/database > > Cliquez sur enterprise Une fois connecté, cliquez sur le bouton `Continue` qui apparaît à droite. > Screenshot — https\://container-registry.oracle.com/ords/ocr/ba/database > > Acceptation des termes de la licence Une fenêtre popup s'affiche et, en bas, vous devrez cliquer sur `Accept`. Optionnel : en retournant sur , vous verrez qu'Oracle a bien enregistré le fait que vous avez accepté ses conditions. > Screenshot — https\://container-registry.oracle.com/ords/ocr/ba/database > > Acceptation du contrat de licence ### Configurer votre environnement Docker local {#configure-your-local-docker-environment} Dernière partie : apprendre à Docker que vous pouvez télécharger depuis le registre Oracle. Allez en ligne de commande et tapez `docker login container-registry.oracle.com`. Renseignez votre **SSO Username** et votre **Secret Key** (donnés par la page Auth Token sur oracle.com). Docker affichera *Login Succeeded*. > **Optionnel, voici la commande de déconnexion:** > > Si besoin, exécutez `docker logout container-registry.oracle.com` pour supprimer l'authentification vers oracle.com sur votre machine. > **Optionnel, l'authentification est stockée dans le fichier config.json:** > > En exécutant `cat ~/.docker/config.json`, vous verrez dans `auths` la présence du registre Oracle > > **\~/.docker/config.json** > > ```json > { > "auths": { > "container-registry.oracle.com": {}, > "https://index.docker.io/v1/": {} > } > } > ``` ### Enfin, vous pouvez récupérer l'image {#finally-you-can-pull-the-image} Si toutes les étapes précédentes ont été correctement réalisées, vous devriez maintenant pouvoir lancer `docker pull container-registry.oracle.com/database/enterprise:latest` sans erreur et télécharger l'image Docker de 3,5 Go. > **L'image latest est énorme mais la slim est trop ancienne:** > > Il existe une image slim d'environ 1,5 Go (`docker pull container-registry.oracle.com/database/enterprise:12.2.0.1-slim`) mais elle est très ancienne (quelque part en 2018). ## Concepts importants à connaître avec Oracle v12 et suivants (passez cette section si vous voulez juste le lancer) {#important-concepts-to-consider-when-working-with-oracle-v12-and-after-skip-this-if-you-just-want-to-run-it} ### Container database (CDB) versus Pluggable database (PDB) {#container-database-cdb-versus-pluggable-database-pdb} Dans l'architecture multi-tenant d'Oracle (introduite depuis Oracle 12c), les concepts de *Container Database* (`CDB`) et de **Pluggable Database** (`PDB`) sont fondamentaux. Par rapport aux autres moteurs de base de données, une `PDB` est une base de données tandis que la `CDB` est l'*infrastructure sous-jacente qui gère une ou plusieurs PDB, en partageant des processus d'arrière-plan et de la mémoire*. > **Dans cet article, nous ne travaillons jamais au niveau CDB:** > > Dans cet article, nous voulons uniquement créer des tables dans une base de données (PDB) — **nous devons toujours nous assurer d'être connectés à une PDB au moment de créer des tables.** Nous voulons que nos tables soient dans une seule base ; pas « partagées » à la racine du CDB. > > Donc, chaque fois que nous devrons travailler sur des tables, assurez-vous de vous connecter à la `PDB`. ## Créer un container de base de données Oracle {#create-an-oracle-database-container} Une fois l'image récupérée, nous pouvons créer notre container, c'est-à-dire notre service de base de données Oracle. La liste des options de ligne de commande supportées est ici : Si on le souhaite, on peut lancer une commande `docker run` tout de suite mais, avant, faisons un peu de configuration. Pourquoi ? Parce que la génération du container est terriblement lente et peut prendre jusqu'à dix minutes. Pour être le plus efficace possible, nous allons d'abord créer un ensemble de fichiers sur notre disque pour que, pendant la création de la base, Docker crée aussi automatiquement quelques tables et y insère des enregistrements. ### Création de quelques fichiers de configuration {#creation-of-some-configuration-files} Créez un nouveau dossier sur votre disque, allez-y, puis créez le dossier où nous mettrons nos fichiers de démarrage : ```bash $ mkdir -p /tmp/oracle && cd $_ $ mkdir -p scripts/startup ``` #### Créons une base d'exemple Human Resources {#lets-create-a-human-resources-sample-database} Oracle fournit des bases d'exemple sur la page [Oracle Database Sample Schemas](https://github.com/oracle-samples/db-sample-schemas/releases). Vous pouvez y télécharger l'archive `db-sample-schemas-23.3.zip`, l'ouvrir et aller dans le dossier `human_resources`. Vous y trouverez un fichier appelé `hr_create.sql` qui est un exemple de base RH. Il y a un second fichier appelé `hr_populate.sql` pour remplir les tables avec des données. > **Information:** > > Pour simplifier, vous pouvez récupérer ces fichiers en cliquant sur ces deux liens : [hr\_create.sql](./files/hr_create.sql) et [hr\_populate.sql](./files/hr_populate.sql). Téléchargez et copiez ces deux fichiers dans le dossier `scripts/startup/sql/` que vous avez créé précédemment. La deuxième chose à faire est de créer le fichier `scripts/startup/populate_db.sh` avec le contenu ci-dessous pour automatiser la création de nos tables et insérer des enregistrements dans notre base. Comme dit dans un chapitre précédent, il est important de bien se connecter à la `PDB` pour que les tables soient créées dans une base de données, pas dans le container. **scripts/startup/populate\_db.sh** ```bash #!/usr/bin/env bash sqlplus -S sys/admin@localhost:1521/ORCLCDB AS SYSDBA < **Les tables appartiendront à l'utilisateur system:** > > Faites attention à l'instruction `CONNECT system/admin@` orclpdb1 `: nous nous connectons d'abord en tant qu'utilisateur system avant de créer les tables. Les tables seront donc accessibles par cet utilisateur, à savoir l'utilisateur`system\`. Si vous avez besoin du modèle de données, le voici :  ### Créer le volume OracleDBData {#create-the-oracledbdata-volume} Comme lancer le container est un processus très lent, nous allons créer un volume Docker pour garder la base persistante sur le disque. Le volume conservera la base sur notre disque, dans un volume géré par Docker. Ainsi, nous pouvons arrêter le container Oracle, le redémarrer et nous ne perdrons pas notre base. *La base sera persistante dans un volume auto-géré par Docker.* Lancez cette commande dans la console pour créer un volume géré par Docker : ```bash $ docker volume create OracleDBData ``` ### Créer le réseau oracle {#create-the-oracle-network} Et enfin, nous allons créer un réseau spécifique pour notre container Oracle : ```bash $ docker network create oracle ``` ### Prêt à créer le container {#ready-to-create-the-container} Nous sommes prêts à créer notre container en lançant cette commande : ```bash $ docker run -d \ --name oracle-db \ --network oracle \ -p 1521:1521 \ -p 5500:5500 \ -e ORACLE_SID=ORCLCDB \ -e ORACLE_PDB=ORCLPDB1 \ -e ORACLE_PWD=admin \ -v OracleDBData:/opt/oracle/oradata \ -v ./scripts/startup/:/docker-entrypoint-initdb.d/startup \ container-registry.oracle.com/database/enterprise:latest ``` > **Note:** > > C'est terriblement lent... Oracle aura besoin d'environ 10 minutes avant que le container soit utilisable. La commande `docker run` était terriblement complexe ; voici le détail : * `--name oracle-db` : notre container s'appellera oracle-db (nous pourrons donc y accéder plus tard avec `docker exec -it oracle-db [...]`), * `--network oracle` : nous créerons notre container sur le réseau `oracle`, * `-p 1521:1521` : Oracle utilise le port 1521 (Oracle Listener) et nous exposons ce port sur notre machine, * `-p 5500:5500` : optionnel. Oracle utilise un second port 5500 (OEM Express) et nous exposons également ce port pour pouvoir accéder à `http://localhost:`5500, * `-e ORACLE_SID=ORCLCDB` : le SID de la base Oracle (SID signifie *System identifier*) est un réglage très important. Nous gardons la valeur par défaut, à savoir ORCLCDB (rappel : `CDB` signifie `Container database`) * `-e ORACLE_PDB=ORCLPDB1` : le nom de la PDB Oracle. Ici aussi, nous gardons la valeur par défaut, à savoir ORCLPDB1. (rappel : `PDB` signifie `pluggable database`). * `-e ORACLE_PWD=admin` : le mot de passe des utilisateurs SYS, SYSTEM et PDBADMIN. Il n'y a pas de valeur par défaut puisque le mot de passe est généré automatiquement et doit être récupéré dans les logs (`docker log`). Ce paramètre modifie le mot de passe des utilisateurs SYS, SYSTEM et PDBADMIN. * `-v OracleDBData:/opt/oracle/oradata` : nous rendons la base persistante sur notre disque mais peu importe *où*, nous laissons Docker gérer ça. Nous avons créé précédemment un volume Docker nommé `OracleDBData`. * `-v ./scripts/startup/:/docker-entrypoint-initdb.d/startup` : cela nous permet de créer des fichiers en local dans le dossier `./scripts/startup` (comme nos fichiers SQL) et de les exécuter dans le container une fois la base Oracle principale prête. Et, en effet, nous avons créé précédemment les fichiers `populate_db.sh`, `sql/hr_create.sql` et `sql/hr_populate.sql` dans notre dossier `scripts/startup`. ## Constantes importantes à retenir {#important-constants-to-remember} À partir de maintenant, notre serveur de base de données Oracle tourne dans un container Docker. Nous allons beaucoup utiliser certaines constantes. Voici les constantes à retenir : * 1521 est le numéro de port à utiliser pour se connecter au service Oracle DB, * oracle-db est le nom de notre container, * ORCLCDB est le nom de notre CDB, * ORCLPDB1 est le nom de notre pluggable database, * `admin` est le mot de passe à utiliser et * `system` est l'utilisateur employé lors de la création de la base Si vous reprenez le script `populate_db.sh`, nous avions : **scripts/startup/populate\_db.sh** ```bash # highlight-next-line sqlplus -S sys/admin@localhost:1521/ORCLCDB AS SYSDBA < **Suis-je connecté au container database ou à une pluggable database ?:** > > Lancez simplement, dans la console SQL\*Plus, la commande `SHOW CON_NAME;`. > >  > > Si vous êtes connecté au CDB, vous obtiendrez la réponse suivante et c'est faux. Tapez `exit` et connectez-vous à la PDB. > >  ### Un mot sur le schéma {#a-word-about-schema} Précédemment, nous avons créé nos tables avec le script `scripts/startup/populate_db.sh`. Voici le script utilisé : **scripts/startup/populate\_db.sh** ```bash #!/usr/bin/env bash sqlplus -S sys/admin@localhost:1521/ORCLCDB AS SYSDBA < **Information:** > > `SET WRAP OFF` nous permet d'utiliser toute la largeur de l'écran au lieu d'une largeur ridicule de 80 caractères et `SET PAGESIZE 1000` évite une liste paginée tous les 10 enregistrements. ### Accéder à Oracle Enterprise Manager Database Express {#accessing-the-oracle-enterprise-manager-database-express} Plus tôt, lors de notre commande `docker run`, nous avons mappé le port 5500 du container sur notre host. Ce port est celui utilisé par Oracle Enterprise Manager Database Express (alias `OEM Express`). C'est une application web accessible en surfant sur `https://localhost:` 5500`/em/`. Connectez-vous avec `system` / `admin` et orclpdb1 comme nom de container. > Screenshot — https\://localhost:5500/em/ > > Oracle Enterprise Manager Database Express ### Accéder à notre base avec les outils Oracle {#accessing-our-database-using-oracle-tools} #### Oracle SQL Developer {#oracle-sql-developer} Vous pouvez télécharger [Oracle SQL Developer](https://www.oracle.com/be/database/sqldeveloper). C'est un fichier ZIP et, une fois dézippé, vous pouvez lancer l'interface sans devoir installer le logiciel : c'est prêt à l'emploi. Une fois installé, lancez-le et créez une nouvelle connexion vers : | Label | Value | | -------------- | ----------- | | Utilisateur | `SYS` | | Rôle | `SYSDBA` | | Mot de passe | `admin` | | Nom d'hôte | `127.0.0.1` | | Port | `1521` | | Nom du service | `orclpdb1` |  > **Rappel : vous devez vous connecter à notre PDB, pas au CDB:** > > Les tables se trouvent dans la *pluggable database* (`PDB`), pas dans le *container database* (`CDB`)  Commencez à taper `SELECT * FROM system.` et appuyez sur `CTRL`+`SPACE` pour obtenir la liste des objets de ce schéma. En descendant un peu, vous trouverez employees.  Validez ou tapez simplement le SQL complet `SELECT * FROM system.employees`. Dans l'exemple ci-dessous, je demande la liste des régions et la liste des employés. Je lance la query en appuyant simplement sur `F5` — le même résultat que celui déjà montré en début d'article. ##### Se connecter à Oracle SQL Developer avec le bon utilisateur {#connect-to-oracle-sql-developer-using-the-correct-user} Dans le chapitre précédent, nous avons créé une connexion avec `sys` comme nom d'utilisateur et, pour cette raison, si nous cliquons sur le menu `Tables (Filtered)` dans l'arborescence de gauche, nous obtiendrons un paquet de tables mais pas celles de l'utilisateur `system`, comme notre table employees.  Maintenant, en dépliant la liste des tables, nous voyons les nôtres :  #### Accéder à notre container Oracle DB avec Oracle SQLPlus {#access-our-oracle-db-container-using-oracle-sqlplus} Une autre façon serait d'utiliser l'image Docker officielle sql\*plus comme ceci : ```bash $ docker run --rm -it --network oracle oracletools/sqlplus:v19.18_lin SYS/admin@oracle-db:1521/orclpdb1 as sysdba ``` Une fois connectés, nous pouvons par exemple obtenir la liste des pays comme ceci :  > **Interne versus externe:** > > Pour cet article, il n'était pas vraiment nécessaire d'utiliser cette image. Jusqu'ici, nous avons utilisé SQL\*Plus plus d'une fois, par exemple quand nous avons lancé `docker exec -it ` oracle-db ` sqlplus sys/admin@` ORCLPDB1 ` as sysdba` pour nous connecter à la base. > > La différence : `docker exec -it ` oracle-db ` [...]` entre dans le container de notre base et lance sqlplus *en interne* (depuis le container où la base est stockée) tandis que `docker run [...] oracle oracletools/sqlplus:v19.18_lin [...]` lance sqlplus *à l'extérieur*, dans un container séparé. ## Pour aller plus loin {#going-further} Maintenant que le container oracle-db tourne, deux articles de suite le réutilisent directement : [Transform an Oracle DB as OpenData using Oracle REST Data Services](/blog/docker-oracle-ords) et [Accessing an Oracle database using .Net, NodeJS, PHP and Python](/blog/oracle-dotnet-nodejs-php-python).