kuma-website icon indicating copy to clipboard operation
kuma-website copied to clipboard

Add tutorial for running Kuma on universal using Docker and our published images

Open jijiechen opened this issue 1 year ago • 1 comments

Description

In our current version of Universal quickstart guide, we are teaching people run kuma-dp and kuma-cp services using the binaries directly. From a VM perspective, people also would like to run 3rd party software using the Docker tool chain, etc.

The approach we introduced in our current guide has a few drawbacks:

  • the user needs to run multiple kuma-dp instances on the same host. This is not a typical nor recommeded way of running Kuma
  • Running multiple kuma-dp instances on a single host bings some issues:
    • Port conflicts, reported by multiple users, for example: https://github.com/kumahq/kuma-website/issues/1997
    • Transparent proxy can't be enabled hence Mesh DNS support can't be used by the application
  • Envoy depends on a higher version of glibc, this can cause troubles for some users who are using distrios shipping with older versions of glibc

So it's benifitial to include a tutorial helping people build application images combined with Kuma images with their own application images, and introduce how the mesh is run in this way.

jijiechen avatar Oct 25 '24 03:10 jijiechen