Page MenuHomeDevCentral
Files F3768940

README.md
No OneTemporary
Actions

README.md
View Options

# Webserver content
## Goal of this role
This role provisions the `/var/wwwroot` folder with the website content,
when there is a custom logic to prepare it, like a specific Git repository
to clone, or a build process to follow.
This roles does NOT describe web server configuration,
which is done in other `webserver-` roles.
## Structure
This role doesn't follow the role/unit folder hierarchy.
Instead, it follows a tld/domain/subdomain.sls logic.
For example, the folder for the `*.acme.tld` sites will be `tld/acme`.
This structure goal is to play nice with the Salt include syntax, as dots
are a directory spearator.
The bipbip.acme.tld site will be described in `tld/acme/bipbip.sls` file.
## Add a new domain
1. Create a new folder hierarchy for the domain
2. Include a `init.sls` file for your subdomains
3. Declare the new domain in pillar/webserver/sites.sls
4. Regenerate the role index with utils/generate-webcontent-index.py (or make)
utils/generate-webcontent-index.py > roles/webserver-content/init.sls
For example the tld/acme/init.sls file could be:
```
include:
- .www
- .acme
```
Alphabetical order is followed, but www is generally first.
In the pillar file, website are assigned to a role.
If you wish to deploy all the sites on one role, you can directly include
the folder, and your init.sls will do the rest.
If not, two strategies exist: you can use node.filter_by_role in your
init.sls too or perhaps more simply you can document in init.sls this
roles can't be deployed directly, and make references to sls files in
the pillar (without final .sls extension).
For example to deploy bipbip.acme.tld (`tld/acme/bipbip.sls`) on servers
with the shellserver role:
```
shellserver:
- .tld/acme/bibpip
```
## Prune old files
If you need to prune a former website, you can add
the directory to the /hotfixes/old-directories.sls state.
There is no need to revert your commit when the
directories or files are deleted.

File Metadata

Mime Type
text/plain
Expires
Mon, Nov 25, 11:30 (1 d, 13 h)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
2260093
Default Alt Text
README.md (1 KB)

Event Timeline

Nasqueron DevCentral · If it had been much bigger the moon would have had a core of ice. · Powered by Phabricator