Build a custom Docker image

Uses: Kong Gateway

Deployment Platform:

Prerequisites

Download the Kong Gateway entry-point script.

Download the Kong Gateway entry-point script:

 curl -O https://raw.githubusercontent.com/Kong/docker-kong/master/docker-entrypoint.sh

Copied to clipboard!

Make the script executable:
```
 chmod +x docker-entrypoint.sh
```
Copied to clipboard!

Download the Kong Gateway base image

Create a Dockerfile

Create a Dockerfile using any of the following templates:

cat <<EOF > Dockerfile

FROM debian:bookworm-slim
   
COPY kong.deb /tmp/kong.deb
   
RUN set -ex; \
    apt-get update \
    && apt-get install --yes /tmp/kong.deb \
    && rm -rf /var/lib/apt/lists/* \
    && rm -rf /tmp/kong.deb \
    && chown kong:0 /usr/local/bin/kong \
    && chown -R kong:0 /usr/local/kong \
    && ln -s /usr/local/openresty/luajit/bin/luajit /usr/local/bin/luajit \
    && ln -s /usr/local/openresty/luajit/bin/luajit /usr/local/bin/lua \
    && ln -s /usr/local/openresty/nginx/sbin/nginx /usr/local/bin/nginx \
    && kong version
   
COPY docker-entrypoint.sh /docker-entrypoint.sh
   
USER kong
   
ENTRYPOINT ["/docker-entrypoint.sh"]
   
EXPOSE 8000 8443 8001 8444 8002 8445 8003 8446 8004 8447
   
STOPSIGNAL SIGQUIT
   
HEALTHCHECK --interval=10s --timeout=10s --retries=10 CMD kong health
   
CMD ["kong", "docker-start"]
EOF

Copied to clipboard!

cat <<EOF > Dockerfile
FROM registry.access.redhat.com/ubi9/ubi:9.5
   
COPY kong.rpm /tmp/kong.rpm
   
RUN set -ex; \
    yum install -y /tmp/kong.rpm \
    && rm /tmp/kong.rpm \
    && chown kong:0 /usr/local/bin/kong \
    && chown -R kong:0 /usr/local/kong \
    && ln -s /usr/local/openresty/luajit/bin/luajit /usr/local/bin/luajit \
    && ln -s /usr/local/openresty/luajit/bin/luajit /usr/local/bin/lua \
    && ln -s /usr/local/openresty/nginx/sbin/nginx /usr/local/bin/nginx \
    && kong version
   
COPY docker-entrypoint.sh /docker-entrypoint.sh
   
USER kong
   
ENTRYPOINT ["/docker-entrypoint.sh"]
   
EXPOSE 8000 8443 8001 8444 8002 8445 8003 8446 8004 8447
   
STOPSIGNAL SIGQUIT
   
HEALTHCHECK --interval=10s --timeout=10s --retries=10 CMD kong health
   
CMD ["kong", "docker-start"]
EOF

      
        
      
    
Copied to clipboard!

cat <<EOF > Dockerfile
FROM ubuntu:24.04
   
COPY kong.deb /tmp/kong.deb
   
RUN set -ex; \
    apt-get update \
    && apt-get install --yes /tmp/kong.deb \
    && rm -rf /var/lib/apt/lists/* \
    && rm -rf /tmp/kong.deb \
    && chown kong:0 /usr/local/bin/kong \
    && chown -R kong:0 /usr/local/kong \
    && ln -s /usr/local/openresty/luajit/bin/luajit /usr/local/bin/luajit \
    && ln -s /usr/local/openresty/luajit/bin/luajit /usr/local/bin/lua \
    && ln -s /usr/local/openresty/nginx/sbin/nginx /usr/local/bin/nginx \
    && kong version
   
COPY docker-entrypoint.sh /docker-entrypoint.sh
   
USER kong
   
ENTRYPOINT ["/docker-entrypoint.sh"]
   
EXPOSE 8000 8443 8001 8444 8002 8445 8003 8446 8004 8447
   
STOPSIGNAL SIGQUIT
   
HEALTHCHECK --interval=10s --timeout=10s --retries=10 CMD kong health
   
CMD ["kong", "docker-start"]
EOF

      
        
      
    
Copied to clipboard!

Build the image

Using the docker build command, you can build the image:

docker build --platform linux/amd64 --no-cache -t kong-image .

Copied to clipboard!

Docker will build the image according to the parameters set in the Dockerfile.

Validate the image

Validate that the image was built correctly using docker run:

docker run -it --rm kong-image kong version

Copied to clipboard!

If the image was built correctly, a Docker container will start and output the Kong Gateway Enterprise version to the console.

FAQs

What can I do with a Kong Gateway custom image?