Page Comparison

Installation

...

on Docker

The Connect Server can be operated under Docker. On Windows, only the "modern" Docker variant (Docker with WSL2) is supported. For operation under DockerIn Docker-based environments, we recommend using the delivery as a portable .NET assembly, since the platform-specific variants of the Connect Server are not explicitly tested for operation under Dockerthis scenario.

As a basis for the creation of the image you need a Linux distribution and the current version of the ASP.NET Core 6.0 runtime environment. A corresponding image is provided by Microsoft, for example, but it can also be but you may also use a custom image created according to your own requirements.

...

FROM mcr.microsoft.com/dotnet/aspnet

LABEL Description="This image contains the Connect! Server." Vendor="Galileo Group AG" Version="2022.0.3.704"

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install net-tools
RUN apt -y install iputils-ping
RUN apt -y install vim
RUN apt -y install procps

COPY . /connect/app

# >>> Use this to store persistent data on volume /connect/data
#     Things to do before starting the container:
#     - Create JSON file "appsettings" containing configuration settings (see user manual for further information)
VOLUME /connect/data
# <<<

# >>> Use this to store persistent data in container (for test purposes only!)
# RUN mkdir /connect/data
# RUN echo "{}" > /connect/data/appsettings.json
# <<<

# >>> Use this to add specific trusted root certificates
# COPY my_trusted_root_ca1.crt /usr/local/share/ca-certificates/
# COPY my_trusted_root_ca2.crt /usr/local/share/ca-certificates/
# COPY my_trusted_root_ca3.crt /usr/local/share/ca-certificates/
# RUN update-ca-certificates
# <<<

WORKDIR /connect/app
ENTRYPOINT ["dotnet", "GalileoGroup.Connect.Server.dll", "--settings=/connect/data/appsettings.json?"]

EXPOSE 80/tcp
EXPOSE 443/tcp

...

docker build -t connect .

In this example, the web server inside the Docker image uses the default configuration and is accessible via HTTP on port 80. If required, an HTTPS configuration on port 443 can be added. Externally, any port can be used for the container.

Creating a Docker Container

...

docker run -d -v c:\connect\data:/connect/data -p 8000:80 --dns 192.168.1.110 --name myconnect connect

In this example, the web server inside the Docker image uses the default configuration and is accessible via HTTP on port 80. If required, an HTTPS configuration on port 443 can be added. Externally, any port can be used for the container.

To avoid keeping the persistent data inside the container, this example creates an external directory named "c:\connect\data". In this directory, a JSON file named "appsettings.json" can be created that contains the environment-specific configuration settings.

...