Add a "Deploying" section to proxy/README.md.

This commit is contained in:
David Fifield 2019-07-27 09:53:09 -06:00
parent 695554cbc5
commit 0bded511b9

View file

@ -26,6 +26,48 @@ To run locally, either:
- For a more fully featured "debug" version, - For a more fully featured "debug" version,
start a webserver and navigate to `snowflake.html`. start a webserver and navigate to `snowflake.html`.
### Preparing to deploy
Background information:
* https://bugs.torproject.org/23947#comment:8
* https://help.torproject.org/tsa/doc/static-sites/
* https://help.torproject.org/tsa/doc/ssh-jump-host/
You need to be in LDAP group "snowflake" and have set up an SSH key with your LDAP account.
In your ~/.ssh/config file, you should have something like:
```
Host staticiforme
HostName staticiforme.torproject.org
User <your user name>
ProxyJump people.torproject.org
IdentityFile ~/.ssh/tor
```
### Deploying
```
npm run build
```
Do a "dry run" rsync with `-n` to check that only expected files are being changed. If you don't understand why a file would be updated, you can add the `-i` option to see the reason.
```
rsync -n --delete -crv build/ staticiforme:/srv/snowflake.torproject.org/htdocs/
```
If it looks good, then repeat the rsync without `-n`.
```
rsync --delete -crv build/ staticiforme:/srv/snowflake.torproject.org/htdocs/
```
Then run the command to copy the new files to the live web servers:
```
ssh staticiforme 'static-update-component snowflake.torproject.org'
```
### Parameters ### Parameters
With no parameters, With no parameters,