startxfr/docker-images

Image OOCONV

STARTX Profile licence Sources last commit Build Status Dockerhub Registry Docker ooconv pulls Docker Repository on Quay

Simple container used to document convertion and manipulation tools Run libreoffice as a daemon using dagwieers unoconv under a container based on startx/fedora container

Available flavours

Docker Hub repository Content Libreoffice Unoconv
startx/sv-ooconv:latest Fedora core rawhide 7.1.3.2 0.7
startx/sv-ooconv:35 Fedora core 35 7.1.3.2 0.7
startx/sv-ooconv:34 Fedora core 34 7.1.3.2 0.7
startx/sv-ooconv:33 Fedora core 33 7.0.5.2 0.7
startx/sv-ooconv:32 Fedora core 32 6.2.4.2.0 0.7
startx/sv-ooconv:31 Fedora core 31 6.3.6.2 0.7
startx/sv-ooconv:30 Fedora core 30 6.1.6.3 0.7
startx/sv-ooconv:29 Fedora core 29 6.1.6.3 0.7
startx/sv-ooconv:28 Fedora core 28 5.0.3.2 0.7
startx/sv-ooconv:27 Fedora core 27 5.0.3.2 0.7
startx/sv-ooconv:26 Fedora core 26 5.0.3.2 0.7
startx/sv-ooconv:23 Fedora core 23 5.0.3.2 0.7
startx/sv-ooconv:22 Fedora core 22
startx/sv-ooconv:21 Fedora core 21
startx/sv-ooconv:20 Fedora core 20
startx/sv-ooconv:centos8 Centos 8 6.3.6.2 0.7
startx/sv-ooconv:centos7 Centos 7 5.3 0.7
startx/sv-ooconv:centos6 Centos 6 4.3.7.2
startx/sv-ooconv:ubi8 RedHat UBI 8 0.7
startx/sv-ooconv:alpine3 Alpine 3.12 6.2.7.1 0.8

Running from dockerhub registry

If you want to be guided on setting-up and installing various containers engines (docker, podman, s2i, dockerEE, kubernetes, openshift) you can read ours containers engines guidelines.

  • with docker you can run docker run -it --name="service-ooconv" startx/sv-ooconv from any docker host
  • with docker-compose you can create a docker-compose.yml file with the following content
service:
  image: startx/sv-ooconv:latest
  container_name: "service-ooconv"
  volumes:
    - "/tmp/container/ooconv/logs:/logs:z"

Using this image as Openshift Build image

You can use this public image as a base image in your openshift build strategy. You can first import our openshift image stream and automatically add them in your service catalog. You can also test our deploy template or our build and deploy template

# import image streams
oc create -f https://raw.githubusercontent.com/startxfr/docker-images/master/Services/ooconv/openshift-imageStreams.yml
# import deploy template and start a sample application
oc create -f https://raw.githubusercontent.com/startxfr/docker-images/master/Services/ooconv/openshift-template-deploy.yml
oc process startx-ooconv-template | oc create -f -
# import build and deploy template and start a sample application
oc create -f https://raw.githubusercontent.com/startxfr/docker-images/master/Services/ooconv/openshift-template-build.yml
oc process startx-ooconv-build-template | oc create -f -

Using this image as S2I builder

You can use this image as an s2i builder image.

s2i build https://gitlab.com/startx1/containers-example-ooconv startx/sv-ooconv test-ooconv
docker run --rm -i -t test-ooconv

Docker-compose in various situations

  • sample docker-compose.yml linked to host port 1000
service:
  image: startx/sv-ooconv:latest
  container_name: "service-ooconv"
  ports:
    - "1000:2002"
  • sample docker-compose.yml with port exposed only to linked services
service:
  image: startx/sv-ooconv:latest
  container_name: "service-ooconv"
  expose:
    - "2002"

Using this image as base container

You can use this Dockerfile template to start a new personalized container based on this container. Create a file named Dockerfile in your project directory and copy this content inside. See docker guide for instructions on how to use this file.

FROM quay.io/startx/ooconv:latest
#... your container specifications
CMD ["/bin/sx", "run"]

Environment variable

This container is based on startx fedora container who came with some additional environment variable

Variable Type Mandatory Description
base image environement see environment list
HOSTNAME auto auto Container unique id automatically assigned by docker daemon at startup
LOG_PATH auto auto default set to /var/log/ooconv and used as a volume mountpoint

Exposed port

Port Description
2002 network port used to communicate with unoconv service

Exposed volumes

Container directory Description
/logs log directory used to record container and ooconv logs

Testing the service

access to the running unoconv service with unoconv client unoconv -s localhost -p 2002. Change port and hostname according to your current configuration

For advanced users

You want to use this container and code to build and create locally this container, follow theses instructions.

This section will help you if you want to :

  • Get latest version of this service container
  • Enhance container content by adding instruction in Dockefile before build step

You must have a working environment with the source code of this repository. Read and follow how to setup your working environment to get a working directory. The following instructions assume you are at the top level of your working directory.

Build & run a container using docker

  1. Jump into the container directory with cd Services/ooconv
  2. Build the container using docker build -t sv-ooconv .
  3. Run this container
  4. Interactively with docker run -p 2002:2002 -v /logs -it sv-ooconv. If you add a second parameter (like /bin/bash) to will run this command instead of the default entrypoint. Usefull to interact with this container (ex: /bin/bash, /bin/ps -a, /bin/df -h,...)
  5. As a daemon with docker run -p 2002:2002 -v /logs -d sv-ooconv

Build & run a container using docker-compose

  1. Jump into the container directory with cd Services/ooconv
  2. Run this container
  3. Interactively with docker-compose up Startup logs appears and escaping this command stop the container
  4. As a daemon with docker-compose up -d. Container startup logs can be read using docker-compose logs

If you experience trouble with port already used, edit docker-compose.yml file and change port mapping