Skip to content

Commit

Permalink
Add tfdocs link to all READMEs
Browse files Browse the repository at this point in the history
  • Loading branch information
saliceti committed Dec 9, 2024
1 parent 2ff9f63 commit 69c7d2c
Show file tree
Hide file tree
Showing 11 changed files with 42 additions and 3 deletions.
3 changes: 3 additions & 0 deletions aks/application/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@

Terraform code for deploying an application.

## Terraform documentation
For the list of requirement, inputs, outputs, resources... check the [terraform module documentation](tfdocs).

## Usage

```terraform
Expand Down
7 changes: 5 additions & 2 deletions aks/application_configuration/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@

Terraform code for generating the application configuration.

## Terraform documentation
For the list of requirement, inputs, outputs, resources... check the [terraform module documentation](tfdocs).

## Usage

```terraform
Expand Down Expand Up @@ -34,9 +37,9 @@ RAILS_LOG_TO_STDOUT=true

Secrets are automatically extracted from an Azure Key Vault using the [AKS Secrets](../secrets) module and exposed to the application via environment variables.

**Azure Key Vault doesn't allow keys with underscores and environment variable names can't have dashes, so dashes are automatically replaced with underscores before being exposed as environment variables.**
**Azure Key Vault doesn't allow keys with underscores and environment variable names can't have dashes, so dashes are automatically replaced with underscores before being exposed as environment variables.**

The short name of the key vault can be customised by setting `secret_key_vault_short`, usually this should either be `null` or set to `"app"`. Any dashes in the keys are automatically converted to underscores.
The short name of the key vault can be customised by setting `secret_key_vault_short`, usually this should either be `null` or set to `"app"`. Any dashes in the keys are automatically converted to underscores.

If your application still has an old-style YAML secret in the key vault, this module can be used to extract the values from it by setting the `secret_yaml_key` variable.

Expand Down
3 changes: 3 additions & 0 deletions aks/cluster_data/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@

Terraform module for managing information about the cluster.

## Terraform documentation
For the list of requirement, inputs, outputs, resources... check the [terraform module documentation](tfdocs).

## Usage

```terraform
Expand Down
3 changes: 3 additions & 0 deletions aks/dfe_analytics/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,9 @@
# DfE Analytics
Create resources in Google cloud Bigquery and provides the required variables to applications so they can send events.

## Terraform documentation
For the list of requirement, inputs, outputs, resources... check the [terraform module documentation](tfdocs).

## Usage
### Reuse existing dataset and events table

Expand Down
3 changes: 3 additions & 0 deletions aks/postgres/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@

Terraform code for deploying a PostgreSQL instance.

## Terraform documentation
For the list of requirement, inputs, outputs, resources... check the [terraform module documentation](tfdocs).

## Usage

```terraform
Expand Down
5 changes: 4 additions & 1 deletion aks/redis/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@

Terraform code for deploying a Redis instance.

## Terraform documentation
For the list of requirement, inputs, outputs, resources... check the [terraform module documentation](tfdocs).

## Usage

```terraform
Expand Down Expand Up @@ -38,4 +41,4 @@ The URL of the Redis instance.

### `connection_string`

A connection string that's compatible with .NET applications to the Redis instance.
A connection string that's compatible with .NET applications to the Redis instance.
3 changes: 3 additions & 0 deletions aks/secrets/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@

Terraform code for extracting secrets from Azure Key Vaults.

## Terraform documentation
For the list of requirement, inputs, outputs, resources... check the [terraform module documentation](tfdocs).

## Usage

```terraform
Expand Down
3 changes: 3 additions & 0 deletions dns/records/readme.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
# DNS records

Terraform code for managing Azure DNS records.

## Terraform documentation
For the list of requirement, inputs, outputs, resources... check the [terraform module documentation](tfdocs).
3 changes: 3 additions & 0 deletions dns/zones/readme.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
# DNS Zones

Terraform code for managing Azure DNS Zones.

## Terraform documentation
For the list of requirement, inputs, outputs, resources... check the [terraform module documentation](tfdocs).
6 changes: 6 additions & 0 deletions domains/environment_domains/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Environment domains

Create domains for each environment in the [domains infrastructure](../infrastructure/). Generates the DNS records as well as front door domain, endpoint, route, origin, redirect rules...

## Terraform documentation
For the list of requirement, inputs, outputs, resources... check the [terraform module documentation](tfdocs).
6 changes: 6 additions & 0 deletions domains/infrastructure/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Domains infrastructure

Create DNS zone, front door and the default DNS records that will be used to support the service domains of each environment, using the [environment_domains module](../environment_domains/README).

## Terraform documentation
For the list of requirement, inputs, outputs, resources... check the [terraform module documentation](tfdocs).

0 comments on commit 69c7d2c

Please sign in to comment.