lumbung.space/README.md

73 lines
2.3 KiB
Markdown
Raw Normal View History

2021-12-15 11:10:02 +00:00
# living room
2021-12-15 09:53:32 +00:00
2022-01-05 10:02:44 +00:00
[![Build Status](https://drone.autonomic.zone/api/badges/ruangrupa/living-room/status.svg?ref=refs/heads/main)](https://drone.autonomic.zone/ruangrupa/living-room)
2021-12-15 11:10:02 +00:00
> A new attempt to bring together the ideas of the "splash" page, "portal" page
> and a comfortable digital "living room" experience for lumbung[dot]space.
> 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.
2021-12-15 11:31:46 +00:00
2022-01-05 12:00:42 +00:00
## FAQ
### How does the CI/CD work?
2022-01-05 12:02:20 +00:00
The [`.drone.yml`](./.drone.yml) triggers a build on [drone.autonomic.zone](https://drone.autonomic.zone/ruangrupa/living-room) of the [`Dockerfile.hugo`](./Dockerfile.hugo) and the [`Dockerfile.scripts`](./Dockerfile.scripts) and then deploys the [`compose.yml`](./compose.yml) stack using `docker stack deploy`.
2021-12-15 11:31:46 +00:00
2022-01-05 12:00:42 +00:00
### How often is the content regenerated?
See the `sleep ...` statements in the [`compose.yml`](./compose.yml).
2022-01-05 12:06:27 +00:00
### How do I see if content generation is working?
(requires `lumbung.space` docker context)
- `docker service logs -f beta_lumbung_space_peertube`
- `docker service logs -f beta_lumbung_space_calendar`
- `docker service logs -f beta_lumbung_space_feed`
2022-01-05 12:06:27 +00:00
Where `beta_lumbung_space_<service-name>` and you see the service name in the [`compose.yml`](./compose.yml).
2022-01-05 12:00:42 +00:00
## Hacking
2021-12-15 11:37:21 +00:00
### Generate the site
2022-01-05 12:00:42 +00:00
[Install Hugo](https://gohugo.io/getting-started/installing/) and `hugo serve --watch`
2021-12-15 11:37:21 +00:00
2021-12-15 11:31:46 +00:00
### Generate `lumbung[dot]space` posts
2021-12-15 11:40:25 +00:00
Do this manually first:
2021-12-15 11:31:46 +00:00
```
2021-12-15 11:35:29 +00:00
mkdir -p content
python3 -m venv .venv && source .venv/bin/activate
pip install git+https://git.autonomic.zone/ruangrupa/lumbunglib
export CALENDAR_URL="https://cloud.lumbung.space/remote.php/dav/public-calendars/WbnHM8YdCkKT6bcT?export"
export OUTPUT_DIR=content/calendar
lumbunglib-cal
export OUTPUT_DIR=content/video
lumbunglib-vid
export OUTPUT_DIR=content/feed
lumbunglib-feed # reads ./feeds_list.txt
2021-12-15 11:31:46 +00:00
```
2021-12-15 11:40:25 +00:00
Afterwards, you can automatically run it with `make gen`.
2022-01-05 12:00:42 +00:00
### 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`
### Deploy a new `feeds_list.txt`
- Increment the `_v<n>` (e.g. `v1` -> `v2`) in [`compose.yml`](./compose.yml) `configs` to avoid any deployment error