Skip to content

Commit

Permalink
Merge pull request #1260 from dgem/1247_helm_chart_readme
Browse files Browse the repository at this point in the history
#1247 helm readme update to tofo-controller
  • Loading branch information
chanwit authored Mar 20, 2024
2 parents dab5b19 + e16d15c commit 786da83
Show file tree
Hide file tree
Showing 2 changed files with 22 additions and 16 deletions.
19 changes: 11 additions & 8 deletions charts/tf-controller/README.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,20 @@
# Weave GitOps Terraform Controller
# Tofu Controller

![Version: 0.16.0-rc.4](https://img.shields.io/badge/Version-0.16.0--rc.4-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square) ![AppVersion: v0.16.0-rc.4](https://img.shields.io/badge/AppVersion-v0.16.0--rc.4-informational?style=flat-square)

The Helm chart for Weave GitOps Terraform Controller
This is the Helm chart for the [Tofu Controller](https://github.com/flux-iac/tofu-controller), an IAC controller for Flux [Flux](https://fluxcd.io) to reconcile OpenTofu and Terraform resources in the GitOps way.

## Prerequisites

Before using tofu-controller, you must install Flux by using either `flux install` or `flux bootstrap` command. For full instructions see [Flux installation](https://fluxcd.io/flux/installation/)

## Installation

Before using TF-controller, you have to install Flux by using either `flux install` or `flux bootstrap` command.
After that you can install TF-controller manually with Helm by:
To install tofu-controller manually using Helm:

```shell
# Add tf-controller helm repository
helm repo add tf-controller https://flux-iac.github.io/tofu-controller/
# Add tofu-controller helm repository
helm repo add tofu-controller https://flux-iac.github.io/tofu-controller/

# Install tf-controller
helm upgrade -i tofu-controller tofu-controller/tf-controller \
Expand All @@ -20,11 +23,11 @@ helm upgrade -i tofu-controller tofu-controller/tf-controller \

### Using cross-namespace references

The Terraform CRD for TF-controller includes references to other objects, for example to a Flux source, which can be in a different namespace to the Terraform. However, being able to access objects in another namespace is usually considered a security risk, so references crossing namespaces are (since version 0.16.0) disallowed by default. If you want to allow them, set the Helm chart value `allowCrossNamespaceRefs: true` (see the table below).
The Terraform CRDs for tofu-controller can include references to other objects, for example to a Flux source, which can be in a different namespace to the Terraform CRD. However, being able to access objects in another namespace is usually considered a security risk, so references crossing namespaces are (since version 0.16.0) disallowed by default. If you want to allow them, set the Helm chart value `allowCrossNamespaceRefs: true` (see the table below).

## Configuration

The following table lists the configurable parameters of the TF-controller chart and their default values.
The following table lists the configurable parameters of the tofu-controller chart and their default values.

__Note__: If you need to use the `imagePullSecrets` it would be best to set `serviceAccount.create: true` and `runner.serviceAccount.create: true`

Expand Down
19 changes: 11 additions & 8 deletions charts/tf-controller/README.md.gotmpl
Original file line number Diff line number Diff line change
@@ -1,17 +1,20 @@
# Weave GitOps Terraform Controller
# Tofu Controller

{{ template "chart.badgesSection" . }}

The Helm chart for Weave GitOps Terraform Controller
This is the Helm chart for the [Tofu Controller](https://github.com/flux-iac/tofu-controller), an IAC controller for Flux [Flux](https://fluxcd.io) to reconcile OpenTofu and Terraform resources in the GitOps way.

## Prerequisites

Before using tofu-controller, you must install Flux by using either `flux install` or `flux bootstrap` command. For full instructions see [Flux installation](https://fluxcd.io/flux/installation/)

## Installation

Before using TF-controller, you have to install Flux by using either `flux install` or `flux bootstrap` command.
After that you can install TF-controller manually with Helm by:
To install tofu-controller manually using Helm:

```shell
# Add tf-controller helm repository
helm repo add tf-controller https://flux-iac.github.io/tofu-controller/
# Add tofu-controller helm repository
helm repo add tofu-controller https://flux-iac.github.io/tofu-controller/

# Install tf-controller
helm upgrade -i tofu-controller tofu-controller/tf-controller \
Expand All @@ -20,11 +23,11 @@ helm upgrade -i tofu-controller tofu-controller/tf-controller \

### Using cross-namespace references

The Terraform CRD for TF-controller includes references to other objects, for example to a Flux source, which can be in a different namespace to the Terraform. However, being able to access objects in another namespace is usually considered a security risk, so references crossing namespaces are (since version 0.16.0) disallowed by default. If you want to allow them, set the Helm chart value `allowCrossNamespaceRefs: true` (see the table below).
The Terraform CRDs for tofu-controller can include references to other objects, for example to a Flux source, which can be in a different namespace to the Terraform CRD. However, being able to access objects in another namespace is usually considered a security risk, so references crossing namespaces are (since version 0.16.0) disallowed by default. If you want to allow them, set the Helm chart value `allowCrossNamespaceRefs: true` (see the table below).

## Configuration

The following table lists the configurable parameters of the TF-controller chart and their default values.
The following table lists the configurable parameters of the tofu-controller chart and their default values.

__Note__: If you need to use the `imagePullSecrets` it would be best to set `serviceAccount.create: true` and `runner.serviceAccount.create: true`

Expand Down

0 comments on commit 786da83

Please sign in to comment.