moosemower
8eb8c2c5e8
The deployment instructions were out of date and duplicated elsewhere, so I've updated the documentation on the rtm-config repo and the how-to-get-access page in our collectives and just pointed the instructions there.
2.9 KiB
hello friends !
To Run the Website Locally
Prerequisites
- Node.js version 18.17.1 or higher (we recommend using NVM to manage Node versions)
- pnpm (optional but recommended)
Step 1: Install correct Node.js version
If you have NVM (Node Version Manager) installed:
nvm install 18.17.1
nvm use 18.17.1
Verify your Node.js version:
node -v
Step 2: Install dependencies
npm install
Step 3: Start the development server
npx astro dev
Tech Stack
- Astro - The core framework
- React - For interactive components
- Tailwind CSS - For styling (find docs here)
- TypeScript - For type safety
To release a new version
Build in the docker image (make sure you have Docker installed!)
Set the version to the next semantic version after the version posted at our co-op cloud's packages site under "rtmwebsite":
version=<specify-version>
docker build --platform linux/amd64 -t git.coopcloud.tech/rtm/rtmwebsite:$version .
Push the image to gitea registry
Check out this documentation for how to login with gitea registery.
# If not in the same terminal session, rerun `version=...` line from last step
docker push git.coopcloud.tech/rtm/rtmwebsite:$version
At our co-op cloud's packages site, click on "rtmwebsite" and check that the version mentioned is the version you specified!
Deploy changes to resisttechmonopolies.online
We use coop cloud tooling private recipe to deploy this website to our fleet of lil cat-named machines.
Read the "Fleet Setup and access" collectives page on our RTM nextcloud to get the rtm-config repo set up with the rtm-astro-recipe submodule and install the abra command line tool!
Then, in your rtm-config repo update the RTM website image version to the one you just built and published by running:
$ abra app config resisttechmonopolies.online # Change VERSION to the docker image you just pushed
$ abra app deploy -f resisttechmonopolies.online # Re-deploy the RTM website, now with your changes!
$ git add abra/servers/laylotta.resisttechmonopolies.online/resisttechmonopolies.online
$ git commit -m 'Updated website to x.x.x' # Publish this change to the rtm-config repo either via direct commit or a PR
Done! Thank you for your contributions 🏋️⚡📖!