doc(enhancement): Katenary is complete, and we can add values-from example
- Katenary is no longer a "bootstraper", it **should** generate a complete Helm chart - Add a `values-from` example, because this label is very useful
This commit is contained in:
23
README.md
23
README.md
@@ -19,11 +19,8 @@ Then call `katenary convert` and let the magic happen.
|
|||||||
|
|
||||||
## What ?
|
## What ?
|
||||||
|
|
||||||
Katenary is a tool to help to transform `docker-compose` files to a working Helm Chart for Kubernetes.
|
Katenary is a tool to help to transform `compose` (`docker compose`, `podman compose`, `nerdctl compose`, ...) files
|
||||||
|
to a working Helm Chart for Kubernetes.
|
||||||
> **Important Note:** Katenary is a tool to help to build Helm Chart from a docker-compose file, but docker-compose
|
|
||||||
> doesn't propose as many features as what can do Kubernetes. So, we strongly recommend to use Katenary as a "bootstrap"
|
|
||||||
> tool and then to manually enhance the generated helm chart.
|
|
||||||
|
|
||||||
Today, it's partially developed in collaboration with [Klee Group](https://www.kleegroup.com). Note that Katenary is
|
Today, it's partially developed in collaboration with [Klee Group](https://www.kleegroup.com). Note that Katenary is
|
||||||
and **will stay an open source and free (as freedom) project**. We are convinced that the best way to make it better is to
|
and **will stay an open source and free (as freedom) project**. We are convinced that the best way to make it better is to
|
||||||
@@ -149,6 +146,10 @@ services:
|
|||||||
# note that "database" is a "compose" service name
|
# note that "database" is a "compose" service name
|
||||||
# so we need to adapt it with the map-env label
|
# so we need to adapt it with the map-env label
|
||||||
DB_HOST: database
|
DB_HOST: database
|
||||||
|
# a pitty to repeat this values, isn't it?
|
||||||
|
# so, let's change them with "values-from" label
|
||||||
|
DB_USER: foo
|
||||||
|
DB_PASSWORD: bar
|
||||||
expose:
|
expose:
|
||||||
- 80
|
- 80
|
||||||
depends_on:
|
depends_on:
|
||||||
@@ -163,11 +164,16 @@ services:
|
|||||||
katenary.v3/map-env: |-
|
katenary.v3/map-env: |-
|
||||||
# make adaptations, DB_HOST environment is actually the service name
|
# make adaptations, DB_HOST environment is actually the service name
|
||||||
DB_HOST: '{{ .Release.Name }}-database'
|
DB_HOST: '{{ .Release.Name }}-database'
|
||||||
|
katenary.v3/values-from: |-
|
||||||
|
# get the values from the "database" service
|
||||||
|
# this will use the databas secret, see below
|
||||||
|
DB_USER: databse.MARIADB_USER
|
||||||
|
DB_PASSWORD: database.MARIADB_PASSWORD
|
||||||
|
|
||||||
database:
|
database:
|
||||||
image: mariadb:10
|
image: mariadb:10
|
||||||
env_file:
|
env_file:
|
||||||
# this will create a configMap
|
# this valuse will be added in a configMap
|
||||||
- my_env.env
|
- my_env.env
|
||||||
environment:
|
environment:
|
||||||
MARIADB_USER: foo
|
MARIADB_USER: foo
|
||||||
@@ -239,7 +245,8 @@ To validate the `katenary.yaml` file, you can use the JSON schema using the "mas
|
|||||||
|
|
||||||
`https://raw.githubusercontent.com/metal3d/katenary/refs/heads/master/katenary.json`
|
`https://raw.githubusercontent.com/metal3d/katenary/refs/heads/master/katenary.json`
|
||||||
|
|
||||||
It's easy to configure in LazyVim, create a Lua file in your plugins directory:
|
It's easy to configure in [LazyVim](https://www.lazyvim.org/), using `nvim-lspconfig`,
|
||||||
|
create a Lua file in your `plugins` directory, or apply the settings as the example below:
|
||||||
|
|
||||||
```lua
|
```lua
|
||||||
-- yaml.lua
|
-- yaml.lua
|
||||||
@@ -274,7 +281,7 @@ Use this address to validate the `katenary.yaml` file in VSCode:
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
You can, of course, replace the `refs/heads/master` with a specific tag or branch.
|
> You can, of course, replace the `refs/heads/master` with a specific tag or branch.
|
||||||
|
|
||||||
## What a name…
|
## What a name…
|
||||||
|
|
||||||
|
Reference in New Issue
Block a user