Skip to content

Welcome

Welcome to the MBSE Docker images repository. Initially started for our Capella Collaboration Manager to run Capella in a browser, we now offer a variety of Docker images to automate processes in the MBSE context.

Use prebuilt images from Github packages

For license reasons, we are only able to provide the following prebuilt public images at this time:

If you need another image, please follow the Build images locally or Build images in a CI/CD environment instructions.

Build images locally

To get started, please clone this repository and include all submodules:

git clone https://github.com/DSD-DBS/capella-dockerimages.git

Build images using our CLI

You can use our command-line interface to build, run and debug our Docker images.

Info

For each image, please execute the steps described in the preparation section in the documentation before building the image.

To install the CLI, install the uv package manager and run the following command:

uv tool install -e ./cli

Then, just run the following command:

cdi --help

Build images manually with Docker

It's important to strictly follow the sequence. Several Docker images depend on each other. The full dependency graph for the images looks like:

flowchart LR
    BASE(base) --> CAPELLA_BASE(capella/base)
    BASE(base) --> JUPYTER(jupyter-notebook)
    BASE(base) --> PAPYRUS_BASE(papyrus/base) --> PAPYRUS_REMOTE(papyrus/remote)
    BASE(base) --> ECLIPSE_BASE(eclipse/base) --> ECLIPSE_REMOTE(eclipse/remote) --> ECLIPSE_REMOTE_PURE_VARIANTS(eclipse/remote/pure-variants)
    CAPELLA_BASE(capella/base) --> T4C_CLIENT_BASE(t4c/client/base)
    CAPELLA_BASE(capella/base) --> CAPELLA_REMOTE(capella/remote) --> CAPELLA_REMOTE_PURE_VARIANTS(capella/remote/pure-variants)
    T4C_CLIENT_BASE(t4c/client/base) --> T4C_CLIENT_REMOTE(t4c/client/remote) --> T4C_CLIENT_REMOTE_PURE_VARIANTS(t4c/client/remote/pure-variants)

    style BASE fill:#b22222,color:#000000
    style CAPELLA_BASE fill:#8feb34,color:#000000
    style JUPYTER fill:#f5626c,color:#000000
    style PAPYRUS_BASE fill:#5f9ea0,color:#000000
    style ECLIPSE_BASE fill:#fafad2,color:#000000
    style T4C_CLIENT_BASE fill:#1e90ff,color:#000000

    style CAPELLA_REMOTE fill:#228b22,color:#000000
    style T4C_CLIENT_REMOTE fill:#228b22,color:#000000
    style ECLIPSE_REMOTE fill:#228b22,color:#000000
    style PAPYRUS_REMOTE fill:#228b22,color:#000000

    style CAPELLA_REMOTE_PURE_VARIANTS fill:#62f5f2,color:#000000
    style T4C_CLIENT_REMOTE_PURE_VARIANTS fill:#62f5f2,color:#000000
    style ECLIPSE_REMOTE_PURE_VARIANTS fill:#62f5f2,color:#000000

Each highlighted color indicates the Dockerfile which is used to build the image:

Base
Capella Base
Eclipse Base
Papyrus Base
T4C Client Base
Remote
pure::variants
Jupyter notebook

Make sure that all docker commands are executed in the root directory of the repository.

For each image, you'll find documentation how to build & run the image manually.

Build images in a CI/CD environment

We provide a Gitlab CI/CD template to build the images in CI/CD environment. Please find the instructions here.