fix(archivebox): Remove unused `postgres` section from `questions.yaml`, add docs (#18488)

**Description**

The `postgres` section in `questions.yaml` was added by accident in the
[original new chart PR](https://github.com/truecharts/charts/pull/18258)
because I copy-pasted a template from an existing project to modify and
didn't notice that line.

Additional minor changes included:

- enable pod `liveness` `probe` on `/health/` by default
- explicitly set `runAsNonRoot: false` and ingress port `protocol: http`
- add new `docs/installation_guide.md`

**⚙️ Type of change**

- [ ] ⚙️ Feature/App addition
- [x] 📖 Documentation addition
- [x] 🪛 Bugfix
- [ ] ⚠️ Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] 🔃 Refactor of current code

**🧪 How Has This Been Tested?**

Tested in TrueNAS scale by installing incubator chart `archivebox` and
setting postgres instaces to 0.

**📝 Notes:**

I still need help with a `missing Chart.yaml` error to get this working:
-
https://github.com/truecharts/charts/pull/18258#issuecomment-1958457400
-
https://www.reddit.com/r/truenas/comments/1awtcbw/help_with_contributing_new_archivebox_chart/

**✔️ Checklist:**

- [x] ⚖️ My code follows the style guidelines of this project
- [x] 👀 I have performed a self-review of my own code
- [x] #️⃣ I have commented my code, particularly in hard-to-understand
areas
- [x] 📄 I have made corresponding changes to the documentation
- [ ] ⚠️ My changes generate no new warnings
- [ ] 🧪 I have added tests to this description that prove my fix is
effective or that my feature works
- [ ] ⬆️ I increased versions for any altered app according to semantic
versioning

---------

Signed-off-by: Nick Sweeting <github@sweeting.me>
Signed-off-by: Kjeld Schouten <info@kjeldschouten.nl>
Co-authored-by: Kjeld Schouten <info@kjeldschouten.nl>
This commit is contained in:
Nick Sweeting 2024-02-22 05:55:00 -08:00 committed by GitHub
parent a2db01abe5
commit d6ed8c78d2
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 65 additions and 1 deletions

View File

@ -0,0 +1,59 @@
---
title: Installation Guide
---
## SCALE App
1. to setup archivebox:
- `App Configuration > Admin Username & Admin Password`
Configure an initial admin username and password you want to log in with in the Web UI (only applied on first setup run).
<img width="500" alt="Screenshot of example Admin Username & Password configuration" src="https://github.com/pirate/truecharts/assets/511499/fcd60d72-2339-4eed-bb13-5c1cd7134236">
- `Networking and Services > Service's Port(s) Configuration > Port`
Configure the port you want to access the ArchiveBox web interface on, or use the pre-populated default.
<img width="500" alt="Screenshot of example Archivebox webserver port configuration" src="https://github.com/pirate/truecharts/assets/511499/f5083399-64e0-4088-8187-dfd92851eb34">
- `Storage and Persistence > App Data Storage`
Setup persistent a persistent storage volume to use for your ArchiveBox `/data` directory.
We recommend using a `Host Path` with `Automatic Permissions Configuration` disabled.
<img width="500" alt="Screenshot of example App Data Storage configuration" src="https://github.com/pirate/truecharts/assets/511499/aa5c4b4f-0285-443b-b654-9d7ceb64ae50">
<sup>Make sure whatever filesystem the data is located on supports FSYNC and doesn't squash permissions.</sup>
<sup>(NFS servers may need to set <code>no_root_squash</code> + <code>no_all_squash</code>)</sup>
For more info about ArchiveBox's filesystem requirements, see here:
- [ArchiveBox Filesystem Requirements](https://github.com/ArchiveBox/ArchiveBox#storage-requirements)
- [ArchiveBox Troubleshooting: Filesystems, NFS, FSYNC](https://github.com/ArchiveBox/ArchiveBox/wiki/Upgrading-or-Merging-Archives#filesystem-doesnt-support-fsync-eg-network-mounts)
- [ArchiveBox Issue #742](https://github.com/ArchiveBox/ArchiveBox/issues/742) (example of common filesystem issue with NFS)
- `Containers > Main Container > Extra Environment Variables` **(optional)**
Optionally add any other [ArchiveBox Configuration](https://github.com/ArchiveBox/ArchiveBox/wiki/Configuration) variables you want here.
<img width="500" alt="Screenshot of example Archivebox extra configuration" src="https://github.com/pirate/truecharts/assets/511499/936b3ca6-28e5-484f-8858-2049c0210a3a">
2. ✅ Then **click `Install`** at the bottom, and wait a few minutes for it to finish deploying.
3. Once deployed, **click `Applications > ArchiveBox > Web Portal` to access ArchiveBox** .
<img width="150" alt="Screenshot TrueNAS Apps UI to access Web Portal" src="https://github.com/pirate/truecharts/assets/511499/08b902c8-7674-427f-b2d1-d546d78855b0" align="top">
<img width="650" alt="Screenshot ArchiveBox UI open in browser" src="https://github.com/pirate/truecharts/assets/511499/12bbcd8a-a473-44f5-8d65-c4cbd7d7d5ab" align="top">
Click the `Log In` (upper right) and proceed with the admin username and password you configured above.
<img width="500" alt="Screenshot of ArchiveBox UI login page" src="https://github.com/pirate/truecharts/assets/511499/ce6a1e1c-45eb-40b4-b4d5-a41b0374cc00">
Optionally change your password from the initial value by going to `Account` in the navbar (`/admin/password_change/`).
<img width="500" alt="Screenshot of ArchiveBox navbar highlighting Account and Add buttons" src="https://github.com/pirate/truecharts/assets/511499/831f5eeb-e5c4-4fff-9f3c-07b9af486dc0">
Click `Add` in the menubar to get started adding new URLs to archive.
---
## Further Reading
- [ArchiveBox Documentation](https://github.com/ArchiveBox/ArchiveBox/wiki/)
- [ArchiveBox UI Usage](https://github.com/ArchiveBox/ArchiveBox/wiki/Usage#ui-usage)
- [ArchiveBox Security Overview](https://github.com/ArchiveBox/ArchiveBox/wiki/Security-Overview)
- [ArchiveBox Configuration](https://github.com/ArchiveBox/ArchiveBox/wiki/Configuration)
- [ArchiveBox Hosting Guide](https://github.com/ArchiveBox/ArchiveBox/wiki/Publishing-Your-Archive)
- [ArchiveBox Changelog](https://github.com/ArchiveBox/ArchiveBox/releases)
### Ask For Help
- [Archivebox Bug Tracker](https://github.com/ArchiveBox/ArchiveBox/issues)
- [ArchiveBox Community Forum / Chat Server](https://zulip.archivebox.io)

View File

@ -101,7 +101,6 @@ questions:
type: int
default: 568
# Include{resources}
# Include{postgresql}
# Include{advanced}
# Include{addons}
# Include{codeserver}

View File

@ -10,6 +10,7 @@ config:
securityContext:
container:
readOnlyRootFilesystem: false
runAsNonRoot: false
runAsGroup: 0
runAsUser: 0
@ -18,6 +19,7 @@ service:
ports:
main:
port: 9598
protocol: http
targetPort: 8000
workload:
@ -25,6 +27,10 @@ workload:
podSpec:
containers:
main:
probes:
liveness:
type: http
path: /health/
env:
ADMIN_USERNAME: "{{ .Values.config.admin_username }}"
ADMIN_PASSWORD: "{{ .Values.config.admin_password }}"