7.0 KiB
7.0 KiB
Armada - Making Your First Armada Yaml
Keywords
keyword | type | action |
---|---|---|
armada |
object | define an armada release |
release_prefix |
string | tag appended to the front of all charts released by the yaml in order to manage them throughout their lifecycles |
charts |
array | stores the definitions of all charts |
chart |
object | definition of the chart |
Defining a chart
To define your charts is not any different than helm. we do provide some post/pre actions that will help us manage our charts better.
Behavior
- will check if chart exists
- if it does not exist
- we will install the chart
- if exist then
- armada will check if there are any differences in the charts
- if the charts are different then it will execute an upgrade
- else it will not perform any actions
- if it does not exist
Chart Keywords
Chart
keyword | type | action |
---|---|---|
name | string | name for the chart |
release_name | string | name of the release |
namespace | string | namespace of your chart |
timeout | int | time (in seconds) allotted for chart to deploy when 'wait' flag is set |
install | object | install the chart into your Kubernetes cluster |
update | object | update the chart managed by the armada yaml |
values | object | override any default values in the charts |
source | object | provide a path to a git repo or local dir
deploy chart. |
dependencies | object | reference any chart dependencies before install |
Source
keyword | type | action |
---|---|---|
type | string | source to build the chart: git or
local |
location | string | url or path to the chart's parent
directory |
subpath | string | relative path to target chart from parent |
reference | string | branch of the repo |
Note
You can use references in order to build your charts, this will reduce the size of the chart definition will show example in multichart below
Simple Example
armada:
release_prefix: "my_armada"
charts:
- chart: &cockroach
name: cockroach
release_name: cockroach
namespace: db
timeout: 20
install:
no_hooks: false
values:
Replicas: 1
source:
type: git
location: git://github.com/kubernetes/charts/
subpath: stable/cockroachdb
reference: master
dependencies: []
Multichart Example
armada:
release_prefix: "my_armada"
charts:
- chart: &common
name: common
release_name: null
namespace: null
timeout: None
values: {}
source:
type: git
location: git://github.com/kubernetes/charts/
subpath: common
reference: master
dependencies: []
- chart: &cockroach
name: cockroach
release_name: cockroach
namespace: db
timeout: 100
install:
no_hooks: false
values:
Replicas: 1
source:
type: git
location: git://github.com/kubernetes/charts/
subpath: stable/cockroachdb
reference: master
dependencies:
- *common
References
For working examples please check the examples in our repo here