This page contains a guide for building and using OpenIFS 48r1 at model version 48R1.1 in a linux based container using Docker.
While this page focuses on the containerised installation, the details presented can be used as a recipe for the underlying dependencies required to install and run OpenIFS 48r1 on a linux system.
Creation of a docker build directory
The first step is to make a directory from which the OpenIFS container can be created and cd into that directory, e.g.
mkdir <openifs-docker-build-dir> cd <openifs-docker-build-dir>
Once inside the <openifs-docker-build-dir> clone or branch from the git repository with the OpenIFS release package, e.g.
git clone --single-branch --branch release ssh://git@git.ecmwf.int/oifs/openifs-48r1.1.git
- Please note that currently access to this repository is restricted to a limited number of users only.
- It is important that the OpenIFS package in the docker build directory is a fresh clone/branch, i.e., not built on your local system.
Once OpenIFS 48r1 has been extracted to your <openifs-docker-build-dir> , then copy the Dockerfile from the release to <openifs-docker-build-dir>
cp <openifs-docker-build-dir>/openifs-48r1.1/scripts/docker/gcc-docker-48r1.1/Dockerfile <openifs-docker-build-dir>/.
This cp step is important because the Dockerfile and the OpenIFS release, i.e., openifs-48r1.1, need to be in the same directory to build the container (see the openifs-48r1.1/scripts/docker/gcc-docker-48r1.1/Dockerfile)
Build the OpenIFS docker image
The following command builds the docker image
docker build --tag "openifs-48r1.1" .
Note the trailing '.' to build in the current dir, which is required.
On a Macbook pro (M1) the initial build of the container, takes about 5 minutes. If you decide to change the Dockerfile following a build, you can just execute the same command and, depending on what you change, subsequent builds can be a lot quicker.
- If a fresh build is required but an image has already been built, then execute the following command, which is the same as above but with no-cache
docker build --no-cache --tag "openifs-48r1.1" .
- The tag name does not need to be provided but it is useful for identifying images.