Skip to content

Commit 7ebd72f

Browse files
committed
Make Vault and Openstack reconfig doc refer each other
1 parent fd387b0 commit 7ebd72f

File tree

2 files changed

+15
-4
lines changed

2 files changed

+15
-4
lines changed

doc/source/configuration/vault.rst

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. _hashicorp-vault:
2+
13
================================
24
Hashicorp Vault for internal PKI
35
================================
@@ -111,6 +113,9 @@ Certificates generation
111113
Create the external TLS certificates (testing only)
112114
---------------------------------------------------
113115

116+
This method should only be used for testing. For external certificates on production system,
117+
See `Installing External TLS Certificates <installing-external-tls-certificates>`__.
118+
114119
Typically external API TLS certificates should be generated by a organisation's trusted internal or third-party CA.
115120
For test and development purposes it is possible to use Vault as a CA for the external API.
116121

doc/source/operations/openstack-reconfiguration.rst

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -35,8 +35,14 @@ On each controller:
3535
Some services may store data in a dedicated Docker volume, which can be removed
3636
with ``docker volume rm``.
3737

38-
Installing TLS Certificates
39-
===========================
38+
.. _installing-external-tls-certificates:
39+
40+
Installing External TLS Certificates
41+
====================================
42+
43+
This section explains the process of deploying external TLS.
44+
For internal and backend TLS, see `Hashicorp Vault for internal PKI
45+
<hashicorp-vault>`__.
4046

4147
To configure TLS for the first time, we write the contents of a PEM
4248
file to the ``secrets.yml`` file as ``secrets_kolla_external_tls_cert``.
@@ -81,8 +87,8 @@ See `Kolla-Ansible TLS guide
8187
<https://docs.openstack.org/kolla-ansible/latest/admin/tls.html>`__ for
8288
further details.
8389

84-
Updating TLS Certificates
85-
-------------------------
90+
Updating External TLS Certificates
91+
----------------------------------
8692

8793
Check the expiry date on an installed TLS certificate from a host that can
8894
reach the OpenStack APIs:

0 commit comments

Comments
 (0)