beenull/ente
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity

Docs

Browse source
This commit is contained in:
Manav Rathi 2024-05-10 20:03:00 +05:30
parent 54c9cdeed8
commit 10fba07e25
No known key found for this signature in database
1 changed files with 32 additions and 36 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

68
web/docs/deploy.md
View file

@ -1,50 +1,46 @@
# Deploying # Deploying
The various web apps and static sites in this repository are deployed on The various web apps and static sites in this repository are deployed on
Cloudflare Pages. Cloudflare Pages using GitHub workflows.
- Production deployments are triggered by pushing to the `deploy/*` branches. - Automated production deployments of `main` daily 8:00 AM IST.
- Automated staging deployments `*.ente.sh` of `main` daily 3:00 PM IST.
- [help.ente.io](https://help.ente.io) gets deployed whenever a PR that - [help.ente.io](https://help.ente.io) gets deployed whenever a PR that
changes anything inside `docs/` gets merged to `main`. changes anything inside `docs/` gets merged to `main`.
- Every night, all the web apps get automatically deployed to a nightly - Production or staging deployments can made manually by triggering the
preview URLs (`*.ente.sh`) using the current code in main. corresponding workflow. There is variant to deploy a single app to
production using the `web-deploy-one.yml` workflow, and a variant to deploy
any one of the apps to `preview.ente.sh` (see below).
- A preview deployment can be made by triggering the "Preview (web)" workflow. These GitHub workflows use the various `yarn deploy:*` commands. For example,
This allows us to deploy a build of any of the apps from an arbitrary branch `yarn deploy:photos` will open a PR to merge the current `main` onto
to [preview.ente.sh](https://preview.ente.sh). `deploy/photos`, which'll trigger the deployment workflow, which'll build and
publish to [web.ente.io](https://web.ente.io).
Use the various `yarn deploy:*` commands to help with production deployments.
For example, `yarn deploy:photos` will open a PR to merge the current `main`
onto `deploy/photos`, which'll trigger the deployment workflow, which'll build
and publish to [web.ente.io](https://web.ente.io).
> When merging these deployment PRs, remember to use rebase and merge so that
> their HEAD is a fast forward of `main` instead of diverging from it because of
> the merge commit.
## Deployments ## Deployments
Here is a list of all the deployments, whether or not they are production Here is a list of all the deployments, whether or not they are production
deployments, and the action that triggers them: deployments, and the action that triggers them:
| URL | Type | Deployment action | | URL | Type | Deployment action |
| -------------------------------------------- | ---------- | -------------------------------------------- | | -------------------------------------------- | ---------- | --------------------------------------------- |
| [web.ente.io](https://web.ente.io) | Production | Push to `deploy/photos` | | [web.ente.io](https://web.ente.io) | Production | Daily deploy of `main` |
| [photos.ente.io](https://photos.ente.io) | Production | Alias of [web.ente.io](https://web.ente.io) | | [photos.ente.io](https://photos.ente.io) | Production | Alias of [web.ente.io](https://web.ente.io) |
| [auth.ente.io](https://auth.ente.io) | Production | Push to `deploy/auth` | | [auth.ente.io](https://auth.ente.io) | Production | Daily deploy of `main` |
| [accounts.ente.io](https://accounts.ente.io) | Production | Push to `deploy/accounts` | | [accounts.ente.io](https://accounts.ente.io) | Production | Daily deploy of `main` |
| [cast.ente.io](https://cast.ente.io) | Production | Push to `deploy/cast` | | [cast.ente.io](https://cast.ente.io) | Production | Daily deploy of `main` |
| [payments.ente.io](https://payments.ente.io) | Production | Push to `deploy/payments` | | [payments.ente.io](https://payments.ente.io) | Production | Daily deploy of `main` |
| [help.ente.io](https://help.ente.io) | Production | Push to `main` + changes in `docs/` | | [help.ente.io](https://help.ente.io) | Production | Changes in `docs/` on push to `main` |
| [staff.ente.sh](https://staff.ente.sh) | Production | Push to `main` + changes in `web/apps/staff` | | [staff.ente.sh](https://staff.ente.sh) | Production | Changes in `web/apps/staff` on push to `main` |
| [accounts.ente.sh](https://accounts.ente.sh) | Preview | Nightly deploy of `main` | | [accounts.ente.sh](https://accounts.ente.sh) | Preview | Daily deploy of `main` |
| [auth.ente.sh](https://auth.ente.sh) | Preview | Nightly deploy of `main` | | [auth.ente.sh](https://auth.ente.sh) | Preview | Daily deploy of `main` |
| [cast.ente.sh](https://cast.ente.sh) | Preview | Nightly deploy of `main` | | [cast.ente.sh](https://cast.ente.sh) | Preview | Daily deploy of `main` |
| [payments.ente.sh](https://payments.ente.sh) | Preview | Nightly deploy of `main` | | [payments.ente.sh](https://payments.ente.sh) | Preview | Daily deploy of `main` |
| [photos.ente.sh](https://photos.ente.sh) | Preview | Nightly deploy of `main` | | [photos.ente.sh](https://photos.ente.sh) | Preview | Daily deploy of `main` |
| [preview.ente.sh](https://preview.ente.sh) | Preview | Manually triggered | | [preview.ente.sh](https://preview.ente.sh) | Preview | Manually triggered |
### Other subdomains ### Other subdomains
@ -60,10 +56,10 @@ Apart from this, there are also some other deployments:
### Preview deployments ### Preview deployments
To trigger a preview deployment, manually trigger the "Preview (web)" workflow To trigger a preview deployment, manually trigger the "Deploy preview (web)"
from the Actions tab on GitHub. You'll need to select the app to build, and the workflow from the Actions tab on GitHub. You'll need to select the app to build,
branch to use. This'll then build the specified app (e.g. "photos") from that and the branch to use. This'll then build the specified app (e.g. "photos") from
branch, and deploy it to [preview.ente.sh](https://preview.ente.sh). that branch, and deploy it to [preview.ente.sh](https://preview.ente.sh).
The workflow can also be triggered using GitHub's CLI, gh. e.g. The workflow can also be triggered using GitHub's CLI, gh. e.g.