Page MenuHomeDevCentral

Generate .env or wp-config.php credentials files for Alkane PHP sites
ClosedPublic

Authored by dereckson on Apr 30 2023, 13:41.
Tags
None
Referenced Files
Unknown Object (File)
Sun, Nov 17, 00:54
Unknown Object (File)
Sun, Nov 17, 00:29
Unknown Object (File)
Tue, Nov 12, 21:39
Unknown Object (File)
Tue, Nov 12, 10:22
Unknown Object (File)
Thu, Nov 7, 17:42
Unknown Object (File)
Tue, Nov 5, 10:46
Unknown Object (File)
Mon, Nov 4, 12:55
Unknown Object (File)
Sat, Nov 2, 04:28
Subscribers
None

Details

Summary

One of the goal of the Alkane PaaS should is to provision secrets securely
through Vault. This strategy is especially important for database access,
as it allows to ease the maintenance of credentials: the same secret is used
to configure both database server and application configuration.

As such, the strategy to provision credentials secrets to PHP applications
is to generate through Salt a .env or a specific app config file with the
relevant credentials, only to be read by the php-fpm pool user.

*Why PHP applications don't fetch secret themselves directly?*

While applications reading the configuration at startup time and initializing
database persistent connections at that moment can query Vault themselves,
this is tricky for PHP applications: they need to do that at EACH request.

To query Vault at each request would require a fast and full HA cluster,
with auto unseal, to avoid to introduce a single point of failure.

For example, we want to be able to upgrade Vault frequently, when new versions
are released, and to still serve credentials during this upgrade, we need such
a cluster.

*Note about saas-wordpress role*

There is a plan to ease WordPress maintenance to create a SaaS like we did
for MediaWiki. Experimental path and config work is ongoing at /srv/wordpress
on Ysul. This is not currently in scope for this change:
the saas-wordpress role is currently strictly limited to generate wp-config.php

Ref T1828 for .env
Ref T1685 for wp-config.php

Test Plan

Deploy on web-001

Diff Detail

Repository
rOPS Nasqueron Operations
Lint
Lint Errors
SeverityLocationCodeMessage
Errorutils/vault/wordpress-provision-secrets.py:106E501flake8 E501
Errorutils/vault/wordpress-provision-secrets.py:117E501flake8 E501
Unit
No Test Coverage
Branch
alkane-wip
Build Status
Buildable 4848
Build 5129: arc lint + arc unit