docs: explain setup

This commit is contained in:
cellarspoon 2022-01-05 13:00:42 +01:00
parent d92732109f
commit 4850c14e37
No known key found for this signature in database
GPG Key ID: 03789458B3D0C410
2 changed files with 29 additions and 4 deletions

View File

@ -7,13 +7,23 @@
> This is a work in progress. The end goal of this is to have a new design and
> implementation for [`lumbung.space`](https://lumbung.space) for January 2022.
## Hacking
## FAQ
[Install Hugo](https://gohugo.io/getting-started/installing/).
### How does the CI/CD work?
[`.drone.yml`](./.drone.yml) builds the [`Dockerfile.hugo`](./Dockerfile.hugo)
and the [`Dockerfile.scripts`](./Dockerfile.scripts) and then deploys the
[`compose.yml`](./compose.yml) stack using `docker stack deploy`.
### How often is the content regenerated?
See the `sleep ...` statements in the [`compose.yml`](./compose.yml).
## Hacking
### Generate the site
`hugo serve --watch`
[Install Hugo](https://gohugo.io/getting-started/installing/) and `hugo serve --watch`
### Generate `lumbung[dot]space` posts
@ -33,3 +43,15 @@ lumbunglib-vid
```
Afterwards, you can automatically run it with `make gen`.
### Manually deploying new images
- `docker login -u decentral1se -p $(logins/dockerhub/decentral1se)`
- `make push-hugo`
- `make push-scripts`
### Manually deploy the site
(requires `lumbung.space` docker context)
- `make deploy`

View File

@ -17,4 +17,7 @@ push-scripts:
@docker build -t decentral1se/beta.lumbung.space-scripts -f Dockerfile.scripts . && \
docker push decentral1se/beta.lumbung.space-scripts
.PHONY: serve gen push-hugo
deploy:
@DOCKER_CONTEXT=lumbung.space docker stack deploy -c compose.yml beta_lumbung_space
.PHONY: serve gen push-hugo push-scripts deploy