Add instructions of deploying a simple static HTML page #572

New Issue

basebuilder · 2024-02-13T10:36:20Z

basebuilder commented

2024-02-13 10:36:20 +00:00

While the current New Operators Tutorial jumps straight to installing NextCloud, which certainly showcases the power of Co-op Cloud 🥳 🦾 that is a more complex app.

I think it would be useful to have a helo recipe which deploys a simple, basic webpage with some cute inviting text + art, and maybe some config values.

While the current [New Operators Tutorial](https://docs.coopcloud.tech/operators/tutorial/) jumps straight to installing NextCloud, which certainly showcases the power of Co-op Cloud 🥳 🦾 that is a more complex app. I think it would be useful to have a `helo` recipe which deploys a simple, basic webpage with some cute inviting text + art, and maybe some config values.

👍 1

basebuilder added this to the Improvements to Websites milestone 2024-02-13 10:36:20 +00:00

basebuilder added the

enhancement

documentation

labels 2024-02-13 10:36:20 +00:00

decentral1se commented

2024-02-13 22:34:10 +00:00

I support this idea 110%. Maybe a forked https://git.coopcloud.tech/coop-cloud/custom-html?

🎉 1

decentral1se changed title from ~~Docs: add instructions of deploying a simple static HTML page~~ to Add instructions of deploying a simple static HTML page

2024-03-27 06:17:11 +00:00

basebuilder commented

2024-04-15 07:12:14 +00:00

Or perhaps now using parasol-static-site but that is scoped to sites build with Hugo, which might be good as the default install does a bit more (pulls from a repo, builds, etc.) than the custom-html which might be helpful in the learning process.

Or perhaps now using [`parasol-static-site`](https://git.coopcloud.tech/coop-cloud/parasol-static-site) but that is scoped to sites build with [Hugo](https://gohugo.io/), which might be good as the default install does a bit more (pulls from a repo, builds, etc.) than the `custom-html` which might be helpful in the learning process.

3wordchant commented

2024-04-21 23:40:56 +00:00

I think there's some value in using an app that (a) people might already be familiar with and (b) demonstrates the power of docker swarm / coop cloud for deploying multiple-service stacks.

I think custom-html doesn't satisfy (b) – if someone is just trying to deploy a static HTML page then I guess coop cloud would seem massively overengineered.

And possibly parasol-static-site is less good than Nextcloud for (a), and maybe even (b)? I'm not sure how many people will be familiar with Hugo, or understand why 2 services would be necessary, compared to things using language-plus-relational-database stack for dynamic functionality.

I think there's some value in using an app that (a) people might already be familiar with and (b) demonstrates the power of docker swarm / coop cloud for deploying multiple-service stacks. I think `custom-html` doesn't satisfy (b) – if someone is just trying to deploy a static HTML page then I guess coop cloud would seem massively overengineered. And possibly `parasol-static-site` is less good than Nextcloud for (a), and maybe even (b)? I'm not sure how many people will be familiar with Hugo, or understand why 2 services would be necessary, compared to things using language-plus-relational-database stack for dynamic functionality.

👍 1

basebuilder commented

2024-04-22 11:27:41 +00:00

if someone is just trying to deploy a static HTML page then I guess coop cloud would seem massively overengineered.

I agree 100%. However, speaking from my own personal experience of trying to migrate sites + apps to Co-op Cloud- I found myself having multiple under used VPS that only served static sites so I wanted to deploy other software to those nodes, but then my brain landed on:

Ok, so if I setup listmonk.eotl.supply on the same node as eotl.supply how do I update my HTML site?

...I'm not sure how many people will be familiar with Hugo, or understand why 2 services would be necessary, compared to things using language-plus-relational-database stack for dynamic functionality.

To me the question is not "how any are using Hugo?" but rather "how many people are still using Wordpress vs. the Static Sites?" I the think the answer to the later (perhaps while still smaller) is a quite high number and they are quite powerful these days. While parasol-static-site currently only works with Hugo, in theory it should be extensible to Jekyll, Pelican, Nuxt, Astro or whatever without too much work. However, the complexity of making any of those easy to update is non-trivial and fiddly.

The recipe @decentral1se led on also covers the following:

Pulling from a private repository
Adding HTTP Basic Auth to a site

So I also see the recipe as a simple path to educating new users with some other useful aspects of Co-op Cloud

> if someone is just trying to deploy a static HTML page then I guess coop cloud would seem massively overengineered. I agree 100%. However, speaking from my own personal experience of trying to migrate sites + apps to *Co-op Cloud*- I found myself having multiple under used VPS that *only* served static sites so I wanted to deploy other software to those nodes, but then my brain landed on: Ok, so if I setup `listmonk.eotl.supply` on the same node as `eotl.supply` how do I update my HTML site? > ...I'm not sure how many people will be familiar with Hugo, or understand why 2 services would be necessary, compared to things using language-plus-relational-database stack for dynamic functionality. To me the question is not *"how any are using Hugo?"* but rather *"how many people are still using Wordpress vs. the Static Sites?"* I the think the answer to the later (perhaps while still smaller) is a quite high number and they are quite powerful these days. While `parasol-static-site` currently only works with Hugo, in *theory* it should be extensible to Jekyll, Pelican, Nuxt, Astro or whatever without too much work. However, the complexity of making any of those easy to update is non-trivial and fiddly. The recipe @decentral1se led on also covers the following: 1. Pulling from a private repository 2. Adding HTTP Basic Auth to a site So I also see the recipe as a simple path to educating new users with some other useful aspects of *Co-op Cloud*

Sign in to join this conversation.

No Milestone

No project

No Assignees

3 Participants

Notifications

Due Date

The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: coop-cloud/organising#572