Skip to content

Commit bd878f0

Browse files
authored
Update production.md docs (#730)
* Update production.md docs * Fix tofu module instructions
1 parent e4937cb commit bd878f0

File tree

1 file changed

+15
-16
lines changed

1 file changed

+15
-16
lines changed

docs/production.md

Lines changed: 15 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -48,21 +48,28 @@ and referenced from the `site` and `production` environments, e.g.:
4848

4949
```
5050
...
51+
variable "environment_root" {
52+
type = string
53+
description = "Path to environment root, automatically set by activate script"
54+
}
55+
5156
module "cluster" {
5257
source = "../../site/tofu/"
58+
environment_root = var.environment_root
5359

5460
cluster_name = "foo"
5561
...
5662
}
5763
```
5864

5965
Note that:
60-
- Environment-specific variables (`cluster_name`) should be hardcoded
61-
into the cluster module block.
62-
- Environment-independent variables (e.g. maybe `cluster_net` if the
63-
same is used for staging and production) should be set as *defaults*
64-
in `environments/site/tofu/variables.tf`, and then don't need to
65-
be passed in to the module.
66+
67+
- Environment-specific variables (`cluster_name`) should be hardcoded
68+
into the cluster module block.
69+
- Environment-independent variables (e.g. maybe `cluster_net` if the
70+
same is used for staging and production) should be set as *defaults*
71+
in `environments/site/tofu/variables.tf`, and then don't need to
72+
be passed in to the module.
6673
6774
- Vault-encrypt secrets. Running the `generate-passwords.yml` playbook creates
6875
a secrets file at `environments/$ENV/inventory/group_vars/all/secrets.yml`.
@@ -120,22 +127,14 @@ and referenced from the `site` and `production` environments, e.g.:
120127
set the "attach" options and run `tofu apply` again - this should show there
121128
are no changes planned.
122129
123-
- Enable `etc_hosts` templating:
124-
125-
```yaml
126-
# environments/site/inventory/groups:
127-
[etc_hosts:children]
128-
cluster
129-
```
130-
131130
- Configure Open OnDemand - see [specific documentation](openondemand.md).
132131
133132
- Remove the `demo_user` user from `environments/$ENV/inventory/group_vars/all/basic_users.yml`
134133
135134
- Consider whether having (read-only) access to Grafana without login is OK. If not, remove `grafana_auth_anonymous` in `environments/$ENV/inventory/group_vars/all/grafana.yml`
136135
137-
- If floating IPs are required for login nodes, modify the OpenTofu configurations
138-
appropriately.
136+
- If floating IPs are required for login nodes, create these in OpenStack and add the IPs into
137+
the OpenTofu `login` definition.
139138
140139
- Consider whether mapping of baremetal nodes to ironic nodes is required. See
141140
[PR 485](https://github.com/stackhpc/ansible-slurm-appliance/pull/485).

0 commit comments

Comments
 (0)