https://github.com/drupol/nix-oracle-db
https://github.com/drupol/nix-oracle-db
Last synced: 7 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/drupol/nix-oracle-db
- Owner: drupol
- Created: 2024-01-23T08:09:57.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-05-30T07:07:57.000Z (about 2 years ago)
- Last Synced: 2025-02-01T20:45:01.528Z (over 1 year ago)
- Language: Nix
- Size: 64.5 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Oracle Database on Nix
The goal of this project is to provide a Nix flake that can be used to build
and use Oracle Database on Nix.
Once the flake is in a working state, it will be published to `nixpkgs`. It is
currently provided in a flake instead of a pull request to foster quick and rapid
external contributions.
## Usage
The only exposed package of this flake is `oracle-database`, there's also a `default`
overlay and a NixOS module.
## NixOS Module
The following modules are exposed:
- `oracle-database` (not working yet)
- `oracle-database-container`
To use a module, add this project in your flake `inputs`:
```nix
nix-oracle-db.url = "github:drupol/nix-oracle-db";
```
Then, add of of the exposed module in your `configuration.nix`:
```nix
# The configuration here is an example; it will look slightly different
# based on your platform (NixOS, nix-darwin) and architecture.
nixosConfigurations.your-box = nixpkgs.lib.nixosSystem {
system = "x86_64-linux"
modules = [
# This is the important part -- add this line to your module list!
inputs.nix-oracle-db.nixosModules.oracle-database-container
];
};
```
And finally, enable the service:
```nix
services.oracle-database-container = {
enable = true;
openFirewall = true;
volumeName = "oracledb";
};
```
The current implementation uses Podman. Switching between Docker and Podman will
be possible in the future.
## Limitations
The Oracle Database container cannot expose the database files to a local
directory. This issue arises because the user-mounted volume is empty, while
Oracle expects a very specific file and directory structure within it. To
resolve this, we would need to copy the necessary files from the container to
the host, and then run the container with the mounted volume. Unfortunately, I
have not yet found an elegant solution to this problem.
More info on this at:
- https://github.com/oracle/docker-images/issues/1533
- https://github.com/oracle/docker-images/issues/640
- https://github.com/OxalisCommunity/oxalis/issues/440
I tested a successful workaround by copying the files from the container to the
host before running the container, but I'm not yet satisfied:
```bash
${lib.getExe pkgs.podman} rm --force --ignore oracledbtmp
${lib.getExe pkgs.podman} create --name oracledbtmp container-registry.oracle.com/database/free:${cfg.version}
${lib.getExe pkgs.podman} cp oracledbtmp:/opt/oracle/oradata ${cfg.volumeName}/
chmod -R 777 ${cfg.volumeName}/oradata
```
## Test
Use `nix build .#oracle-database-test -L`
## Status
Basic binaries are working! I don't like the current implementation, I hope I
will find a better solution in the upcoming days.
## Useful links
- https://docs.oracle.com/en/database/oracle/oracle-database/23/xeinl/database-free-installation-guide-linux.pdf
- https://github.com/gvenzl/oci-oracle-free