Part of the default configuration

This example named docker-005-pineapple-image-from-dockerfile-centos, including all configuration files, is included in the default configuration which is created by Pineapple, so there is no need to create it by hand.

Installation of Docker

This example requires the presence of a Docker daemon. The example How-to: Install latest Docker version in a Vagrant box with CentOS 7.6 using SSH. describes how Pineapple can be used to install Docker on a Vagrant box for the purpose of the example.

For the remaining part of this example is assumed that Docker is installed using the above example. The assumed configuration is:

• The Vagrant box is running CentOS 7.6 and has IP address 192.168.34.10.
• The Docker daemon is accessible at 192.168.34.10:8082.

This is relevant since Pineapple will be accessed using HTTP from the docker container within the Docker daemon within the Vagrant box.

The configuration details

Two schema are used in the model file. The http://pineapple.dev.java.net/ns/module_model_1_0 is used to define the namespace mmd which defines the general infrastructure for models. The http://pineapple.dev.java.net/ns/plugin/docker_1_0 schema is used to define the namespace dkp which is used to define the model for the Docker plugin. Since multiple schemas are used to define the model file, the elements are qualified.

The target-resource attribute defines a reference to the resource which is targeted when the model executed. In this case, the value docker-node is a reference to a resource which defines a Docker daemon.

The dkp:docker element defines the root of model for the Docker plugin.

The dkp:image-from-dockerfile element defines a tagged Docker image which can be used for creation or deletion depending on the invoked operation.

When the model is invoked with the deploy-configuration operation, then target image is created from the source image. The source image is defined by the DockerFile (see detail below).

When the image is created then source directory, defined by the source-directory attribute on element dkp:image-from-dockerfile, is compressed into a TAR archive and uploaded to Docker. Please notice that source directory is defined using the variable modulepath:dockersrc which is resolved at runtime to the directory dockersrc within the module.

Docker unpacks the archive and looks for a Dockerfile in the root of the archive. The Dockerfile along with other file material in the archive is used to create the image.

The name of the target image is defined by the dkp:target-image element.

Dockerfile

The Dockerfile contains:

# Pull base image for builder image
# ----------------------------------
FROM openjdk:11.0-jdk-oraclelinux7 as builder

LABEL maintainer="einheriii@gmail.com"

ARG PINEAPPLE_VERSION=1.12.0
ARG PINEAPPLE_HOME=/var/pineapple
ARG PINEAPPLE_INSTALL=/opt/pineapple

# Map arguments into environment variables
ENV PINEAPPLE_VERSION=${PINEAPPLE_VERSION} \
        PINEAPPLE_HOME=${PINEAPPLE_HOME} \
    PINEAPPLE_INSTALL=${PINEAPPLE_INSTALL}
                
RUN set -eux; \
        yum install -y unzip; \
        rm -rf /var/cache/yum

# Install Pineapple binary 
COPY pineapple-standalone-web-client-${PINEAPPLE_VERSION}.zip /tmp/archive.zip 
RUN unzip /tmp/archive.zip -d /opt; \
        mv /opt/pineapple-standalone-web-client-${PINEAPPLE_VERSION} ${PINEAPPLE_INSTALL}

# make script executable
RUN mkdir -p ${PINEAPPLE_HOME} \
        && chmod +x ${PINEAPPLE_INSTALL}/runPineapple.sh 

# Pull base image for final image
# --------------------------------
FROM openjdk:11.0-jdk-oraclelinux7 

LABEL maintainer="einheriii@gmail.com"

ARG PINEAPPLE_HOME=/var/pineapple
ARG PINEAPPLE_INSTALL=/opt/pineapple
ARG PINEAPPLE_HTTP_HOST=0.0.0.0
ARG PINEAPPLE_HTTP_PORT=8080

# Pineapple is run with user `pineapple`, uid = 1000
# If a volume is mounted from the host or a data container, ensure the same UID is used.
ARG PINEAPPLE_USER=pineapple
ARG PINEAPPLE_GROUP=pineapple
ARG PINEAPPLE_UID=1000
ARG PINEAPPLE_GID=1000

# Map arguments into environment variables
ENV PINEAPPLE_HOME=${PINEAPPLE_HOME} \
    PINEAPPLE_INSTALL=${PINEAPPLE_INSTALL} \
        PINEAPPLE_HTTP_HOST=${PINEAPPLE_HTTP_HOST} \
        PINEAPPLE_HTTP_PORT=${PINEAPPLE_HTTP_PORT} 
        
# Copy directories from builder
COPY --from=builder ${PINEAPPLE_INSTALL} ${PINEAPPLE_INSTALL}
COPY --from=builder ${PINEAPPLE_HOME} ${PINEAPPLE_HOME}

# create user, gruoup and home directory
RUN groupadd -g ${PINEAPPLE_GID} ${PINEAPPLE_GROUP} \
        && useradd -m -u ${PINEAPPLE_UID} -g ${PINEAPPLE_GID} -o -s /bin/bash ${PINEAPPLE_USER} \       
        && chown ${PINEAPPLE_UID}:${PINEAPPLE_GID} ${PINEAPPLE_HOME} \  
        && chown ${PINEAPPLE_UID}:${PINEAPPLE_GID} ${PINEAPPLE_INSTALL}
        
# Set work directory
WORKDIR ${PINEAPPLE_INSTALL}

# Expose port to host
EXPOSE ${PINEAPPLE_HTTP_PORT}

# Define volume
VOLUME ${PINEAPPLE_HOME}

# Define user
USER ${PINEAPPLE_USER}

# Start pineapple when container is created
ENTRYPOINT ${PINEAPPLE_INSTALL}/runPineapple.sh

The image is constructed using a multi-stage build. A builder image is used and then a the final image is constructed.