You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
24 lines
1.1 KiB
24 lines
1.1 KiB
# Developer-local docs build |
|
|
|
```bash |
|
./docs/build.sh |
|
``` |
|
|
|
The output can be found in `generated/docs`. |
|
|
|
# How the Envoy website and docs are updated |
|
|
|
The Envoy website, and docs are automatically built, and pushed on every commit |
|
to master. This process is handled by Travis CI with the |
|
[`publish.sh`](https://github.com/envoyproxy/envoy/blob/master/docs/publish.sh) script. |
|
|
|
In order to have this automatic process there is an encrypted ssh key at the root |
|
of the envoy repo (`.publishdocskey.enc`). This key was encrypted with Travis CLI |
|
and can only be decrypted by commits initiated in the Envoy repo, not PRs that are |
|
submitted from forks. This is the case because only PRs initiated in the Envoy |
|
repo have access to the secure environment variables (`encrypted_b1a4cc52fa4a_iv`, |
|
`encrypted_b1a4cc52fa4a_key`) [used to decrypt the key.](https://docs.travis-ci.com/user/pull-requests#Pull-Requests-and-Security-Restrictions) |
|
|
|
The key only has write access to the Envoy repo. If the key, or the variables |
|
used to decrypt it are ever compromised, delete the key immediately from the |
|
Envoy repo in `Settings > Deploy keys`.
|
|
|