MDriven Docker Deployment
No edit summary
(Replaced content with "{{DISPLAYTITLE:MDriven Docker Local Deployment}} *")
Tags: Replaced Visual edit
Line 1: Line 1:
{{DISPLAYTITLE:MDriven Docker Local Deployment}}
{{DISPLAYTITLE:MDriven Docker Local Deployment}}


Create a docker file for the MDriven Server
*
 
Contents of ''<u>MDrivenServer.Dockerfile</u>''<syntaxhighlight lang="dockerfile">
# syntax=docker/dockerfile:1
 
FROM mcr.microsoft.com/dotnet/sdk:8.0-alpine
 
RUN apk add --upgrade --no-cache \
        curl \
        unzip \
        xmlstarlet
 
WORKDIR /app
 
ARG MS_VERSION
 
RUN curl -O https://mdriven.net/PublicDownloads/MDrivenServerOnCoreVersion.xml \
    && MS_VERSION=$(xmlstarlet sel -t -v "//root/date" MDrivenServerOnCoreVersion.xml) \
    && rm -f MDrivenServerOnCoreVersion.xml \
    && curl -O "https://mdriven.net/PublicDownloads/MDrivenServerCoreLinux_${MS_VERSION}.zip" \
    && unzip "MDrivenServerCoreLinux_${MS_VERSION}.zip" \
    && rm -f "MDrivenServerCoreLinux_${MS_VERSION}.zip"
 
 
RUN dotnet nuget add source /mnt/c/capableobjectswush/Xternal/VistaDB --name  XternatVistaDB
 
ENTRYPOINT ["dotnet", "AppCompleteGenericCore.dll", "-port=5010", "-nohttps"]
</syntaxhighlight>
{| class="wikitable"
!Command
!Description
|-
|<code>FROM mcr.microsoft.com/dotnet/sdk:</code>
<code>8.0-alpine</code>
|Base image for the container MDriven Server app. An Alpine Linux distribution with .NET 8.0 SDK for running .NET applications.
Check https://github.com/dotnet/dotnet-docker/blob/main/README.sdk.md for more .NET SDK container images.
|-
|<code>RUN apk add --upgrade --no-cache \</code>
 
<code>        curl \</code>
 
<code>        unzip \</code>
 
<code>        xmlstarlet</code>
|Updates the existing linux packages and installs packages:  curl for downloading files, unzip for extracting zip file contents and xmlstarlet for parsing xml content.
|-
|<code>WORKDIR /app</code>
|Sets the working dir for the following commands.
|-
|<code>ARG MS_VERSION</code>
|Creates MS_VERSION build-time variable called MS_VERSION.
|-
|<code>RUN curl -O <nowiki>https://mdriven.net/PublicDownloads/MDrivenServerOnCoreVersion.xml</nowiki> \</code>
 
<code>    && MS_VERSION=$(xmlstarlet sel -t -v "//root/date" MDrivenServerOnCoreVersion.xml) \</code>
 
<code>    && rm -f MDrivenServerOnCoreVersion.xml \</code>
 
<code>    && curl -O "<nowiki>https://mdriven.net/PublicDownloads/MDrivenServerCoreLinux_${MS_VERSION}.zip</nowiki>" \</code>
 
<code>    && unzip "MDrivenServerCoreLinux_${MS_VERSION}.zip" \</code>
 
<code>    && rm -f "MDrivenServerCoreLinux_${MS_VERSION}.zip"</code>
|Get the current MDriven Version, use it to download the current MDriven Server app and unzip it into the current working directory. If you have an existing MDriven Server instance, copy the files to the container.<syntaxhighlight>
COPY ./mdriven-files .
</syntaxhighlight>
|-
|<code>RUN dotnet nuget add source /mnt/c/capableobjectswush/Xternal/VistaDB --name  XternatVistaDB</code>
|Add the VistaDB package source.
|-
|<code>ENTRYPOINT ["dotnet", "AppCompleteGenericCore.dll", "-port=5010", "-nohttps"]</code>
|Run the application on port 5010 and over http.
|}
Create a docker file for the Turnkey Server
 
contents of ''<u>MDrivenTurnkey.Dockerfile</u>''<syntaxhighlight lang="dockerfile">
# syntax=docker/dockerfile:1
 
FROM mcr.microsoft.com/dotnet/sdk:8.0-alpine
 
RUN apk add --upgrade --no-cache \
        curl \
        unzip \
        xmlstarlet \
        musl-locales
 
ENV LANG=en_US.UTF-8
ENV LANGUAGE=en_US:en
ENV LC_ALL=en_US.UTF-8
 
RUN locale -a
 
WORKDIR /app
 
ARG TK_VERSION
 
RUN curl -O https://mdriven.net/PublicDownloads/MDrivenTurnkeyOnCoreVersion.xml \
    && TK_VERSION=$(xmlstarlet sel -t -v "//root/date" MDrivenTurnkeyOnCoreVersion.xml) \
    && rm -f MDrivenTurnkeyOnCoreVersion.xml \
    && curl -O "https://mdriven.net/PublicDownloads/MDrivenTurnkeyCoreLinuxMUSL_${TK_VERSION}.zip" \
    && unzip "MDrivenTurnkeyCoreLinuxMUSL_${TK_VERSION}.zip" \
    && rm -f "MDrivenTurnkeyCoreLinuxMUSL_${TK_VERSION}.zip"
 
 
COPY ./turnkey-settings ./App_Data
 
 
ENTRYPOINT ["dotnet", "StreaminAppCoreWebApp.dll", "-port=5020", "-nohttps"]
</syntaxhighlight>
'''NOTE:''' For Turnkey Server, install locale packages and set language to prevent locale errors. The Turnkey uses the OS locale settings to determine which locale file is used by the Turnkey.
copy Turnkey settings to Turnkey ''APP_Data'' Folder. The turnkey-settings folder contains:
 
HardServerUrl Settings: To specify the address to be used by the Turnkey Server.
 
MDrivenServerOverride Settings: TO specify credentials for connecting to the  MDriven Server
 
contents of <u>turnkey-settings/HardServerUrl.xml</u><syntaxhighlight lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<root HardServerUrl="http://localhost:5020">
</root>
</syntaxhighlight>contents of <u>turnkey-settings/MDrivenServerOverride.xml</u><syntaxhighlight lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<root>
  <MDrivenServerOverride MDrivenServerPWD="123456" MDrivenServerUSER="a">http://mdriven-server:5010</MDrivenServerOverride>
</root>
</syntaxhighlight>contents of ''<u>compose.yaml</u>''<syntaxhighlight lang="yaml">
 
services:
  mdriven-server:
    build:
      dockerfile: MDrivenServer.Dockerfile
    networks:
      - app-net
    volumes:
      - mdriven-server-data:/app
    ports:
      - 5010:5010
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:5010"]
      interval: 24h
      timeout: 30s
      retries: 5
      start_period: 30s
 
 
  mdriven-turnkey:
    build:
      dockerfile: MDrivenTurnkey.Dockerfile
    networks:
      - app-net
    volumes:
      - mdriven-turnkey-data:/app
    ports:
      - 5020:5020
    depends_on:
      - mdriven-server
 
 
volumes:
  mdriven-turnkey-data:
  mdriven-server-data:
networks:
  app-net:
 
 
</syntaxhighlight><code>mdriven-server:</code> creates a service for the MDriven Server using the MDrivenServer.Dockerfile file, the MDriven Server is connected to and available in the app-net network. The service is binding port 5010 on your host machine to 5010 port on which the MDriven Server is running in the container. The volume is added to persist the MDriven Server  files in the /app folder whereit  is currently located and running in the container. This allows for updating of the linux OS packages and images while leaving your Server data intact. without a volume, the server data is destroyed when container stops running.
 
The <code>health check:</code> on the MDriven Server is to solve the issue of Vista DB locking itself, a check is performed every after 24 hours and server is restarted to clear the lock state.
 
<code>mdriven-turnkey:</code> creates a service for the MDriven Turnkey using the MDrivenTurnkey.Dockerfile file, the MDriven Turnkey is connected to and available in the app-net network. The service is binding port 5020 on your host machine to 5020 port on which the MDriven Turnkey is running in the container. The volume is added to persist the MDriven Turnkey files in the /app folder where it is currently located and running in the container.
 
Adding <code>depends_on:</code> ensures the Turnkey service only starts after the MDriven Server has started.
 
<code>app-net:</code>  is a network shared by the two services so that they can be able to communicate to each other.
 
==== See also: ====
 
* [[Documentation:WSL Windows subsystem for Linux|WSL Windows subsystem for Linux]]

Revision as of 19:49, 11 November 2024


This page was edited 125 days ago on 11/11/2024. What links here