startx/runner-oc repository overview

⁠Docker gitlab runner : Openshift Client

Simple container used to build & test openshift and kubernetes scripts, using gitlabCI runner, under a container based on startx/fedora container⁠

⁠Available flavours

• :latest : Fedora core rawhide + oc + kubectl + tools
• :fc32 : Fedora core 32 + oc + kubectl + tools
• :fc31 : Fedora core 31 + oc + kubectl + tools
• :fc30 : Fedora core 30 + oc + kubectl + tools
• :fc29 : Fedora core 29 + oc + kubectl + tools
• :fc28 : Fedora core 28 + oc + kubectl + tools
• :fc27 : Fedora core 27 + oc + kubectl + tools
• :centos8 : CentOS 8 + oc + kubectl + tools
• :centos7 : CentOS 7 + oc + kubectl + tools
• :centos6 : Centos 6 + oc + kubectl + tools
• :alpine3 : Alpine 3.10 + oc + kubectl + tools
• :ubi8 : RedHat UBI 8 + oc + kubectl + tools

⁠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-oc" startx/runner-oc from any docker host
• with docker-compose you can create a docker-compose.yml file with the following content

service:
  image: startx/runner-oc:latest
  container_name: "service-oc"
  volumes:
    - "/tmp/container/oc/logs:/logs:z"

⁠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 startx/runner-oc: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⁠

⁠Exposed port

⁠Exposed volumes

⁠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 GitlabRunner/oc
2. Build the container using docker build -t runner-oc .
3. Run this container
4. Interactively with docker run -p 2002:2002 -v /logs -it runner-oc. If you add a second parameter (like /usr/bin/oc) to will run this command instead of the default entrypoint. Usefull to interact with this container (ex: /usr/bin/oc, /bin/ps -a, /bin/df -h,...)
5. As a daemon with docker run -p 2002:2002 -v /logs -d runner-oc

⁠Build & run a container using docker-compose

1. Jump into the container directory with cd GitlabRunner/oc
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