Helm Chart requirements.yaml: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
Line 51: Line 51:
====repository====
====repository====


The dependency chart [[Helm_Concepts#Repository_URL|repository full URL]]. Note that [[Helm_repo#Add_a_New_Repository|helm repo add]] must be used to add the repository locally.
The dependency chart [[Helm_Concepts#Repository_URL|repository full URL]].  
 
The most common case is to specify an on-line repository, as such:
 
<syntaxhighlight lang='yaml'>
- name: postgresql
    version: 6.3.2
    repository: https://kubernetes-charts.storage.googleapis.com
</syntaxhighlight>
 
In this case, [[Helm_repo#Add_a_New_Repository|helm repo add]] must be used to add the repository locally before using the dependent chart.
 
However, we can refer to dependencies that exist on the local filesystem, as such:
<syntaxhighlight lang='yaml'>
- name: my-chart
    version: 1.0.0
    repository: file:///tmp/charts/my-chart
</syntaxhighlight>
 
In case the dependency chart is not archived, but exploded in the files system, the file:// URL must point to the root directory of the chart - the one that contains Chart.yaml.


====alias====
====alias====

Revision as of 23:40, 12 September 2019

External

Internal

Overview

requirements.yaml is an optional metadata file that contains the immediate dependencies for the chart, expressed as a list of name, version and repository URL tuples. Note that the immediate dependencies might have dependencies on their own, which are not expressed in the chart's requirements.yaml file. Helm manages those as well, and after they are discovered, they are written in requirements.lock file. For a general discussion on chart dependencies, see Helm Dependencies.

Structure

dependencies:
- name: blue
  version: 1.2.3
  repository: http://example.com/charts
  alias: something
  condition: something.enabled, global. something.enabled
  tags:
  - front-end
  - big    
- name: green
  version 3.2.1
  repository: http://another.example.com/charts

Example

dependencies:
  - name: postgresql
    version: 6.3.2
    repository: https://kubernetes-charts.storage.googleapis.com

requirements.lock

Transitive Dependencies and requirements.lock File

Fields

name

The dependency chart name.

version

The dependency chart version.

repository

The dependency chart repository full URL.

The most common case is to specify an on-line repository, as such:

- name: postgresql
    version: 6.3.2
    repository: https://kubernetes-charts.storage.googleapis.com

In this case, helm repo add must be used to add the repository locally before using the dependent chart.

However, we can refer to dependencies that exist on the local filesystem, as such:

- name: my-chart
    version: 1.0.0
    repository: file:///tmp/charts/my-chart

In case the dependency chart is not archived, but exploded in the files system, the file:// URL must point to the root directory of the chart - the one that contains Chart.yaml.

alias

TODO: https://helm.sh/docs/developing_charts/#alias-field-in-requirements-yaml

condition

TODO:https://helm.sh/docs/developing_charts/#tags-and-condition-fields-in-requirements-yaml

tags

TODO: https://helm.sh/docs/developing_charts/#tags-and-condition-fields-in-requirements-yaml