Setting up your system

Contents

1. About
2. Linux
3. macOS
4. Next steps

About

In the Before you start you have explored REANA on your laptop from the point of view of a researcher. In this page we'll set up the laptop for REANA development. This will require to pay attention to certain things.

The REANA development is most comfortable on Linux and macOS systems.

Linux

Linux runs containers natively and so is a very good choice for a REANA development platform. Any Linux distribution should do. In experimental particle physics, CentOS/Fedora/RHEL-based distributions are usually used in production systems, and are also primary platforms for many HEP-specific software packages such as XRootD. Consequently, Fedora might be a good Linux distribution choice. We shall use it in the examples below.

At this point, you should have Docker, Kubectl, Kind, and Helm dependencies set up from the Before you start times. If not:

$ # install docker
$ sudo dnf -y install dnf-plugins-core
$ sudo dnf config-manager \
    --add-repo \
    https://download.docker.com/linux/fedora/docker-ce.repo
$ sudo dnf install docker-ce docker-ce-cli containerd.io
$ sudo systemctl enable --now docker
$ sudo usermod -aG docker $USER

$ # install kubectl
$ sudo dnf install kubernetes-client

$ # install kind (from release binaries)
$ curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.11.1/kind-linux-amd64
$ chmod +x ./kind
$ sudo mv ./kind /usr/local/bin

$ # install helm
$ sudo dnf install helm

The novel part in the REANA development is that we would like to be able to comfortably test reana-client with any supported Python version that REANA users can use, which is 3.6+ at the time of this writing. We can install them as follows:

$ sudo dnf install python36 python37 python38 python39 python310 python311

macOS

macOS is another good choice for REANA development platform. Unlike Linux, macOS doesn't run containers natively, and so a "transient" virtual machine is necessary.

Please don't forget to give sufficient memory to the Docker virtual machine. At least 6 CPUs, 8 GB RAM, and 60 GB disk space is recommended. You can set these values in "Docker Desktop for Mac" resource preferences:

Installing several Python versions can be done via pyenv. We recommend to use Homebrew:

$ brew install pyenv

Next steps

The next step is to fork and clone REANA source code to have it available locally. Please proceed to Cloning sources.