0
0
Fork 0
mirror of https://codeberg.org/forgejo/docs.git synced 2024-12-26 22:51:22 -05:00
Commit graph

432 commits

Author SHA1 Message Date
Earl Warren
4ab4393b42
user: actions: contexts and environment variables 2024-01-07 14:48:30 +01:00
Earl Warren
bf93436802
scripts/cli-docs: do not polute the output 2023-12-31 17:27:54 +01:00
Earl Warren
20080b5456
scripts/cli-docs: use only curl 2023-12-31 17:24:40 +01:00
Earl Warren
4d627f5420
scripts/cli-docs: needs jq & curl 2023-12-31 17:21:54 +01:00
Earl Warren
cb05660c81
admin: CLI: generate from --help
because the output of `forgejo docs` is unusable
2023-12-31 17:02:46 +01:00
Earl Warren
cfa5760e60
developer: infrastructure: upgrade and re-install octopuce
* switch to using lxc-helpers alone instead of enough
  the learning curve of
  [enough](https://enough-community.readthedocs.io) is an unecessary
  burden in this context. Manual installation with lxc-helpers and
  documentation is enough when there only is a need for a handful
  of manual intervention per year
* update the Forgejo runner installation instructions
* tested the docker + self-hosted label to work with a test workflow
* do not maintain and setup a self-signed certificate because it creates a
  complication that is unecessary when behind a VPN
2023-12-28 17:18:25 +01:00
Gergely Nagy
5958b3a618
admin: database: Suggest a better collation for MySQL
In `admin/database-preparation` suggest `utf8mb4_bin` as the collate
function, rather than `utf8mb4_unicode_ci`. The former is accent- and
case sensitive, while the latter isn't, and Forgejo assumes that columns
are case sensitive.

Also add a short paragraph explaining why `utf8mb4_bin` is
suggested (case sensitivity), and what problems may arise and why if
case insensitive collation is used.

This partially addresses forgejo/forgejo#2039.

Signed-off-by: Gergely Nagy <me@gergo.csillger.hu>
2023-12-28 11:46:34 +01:00
Earl Warren
cc4162ecb8
admin: actions: 3.3.0 is now the default 2023-12-27 18:43:10 +01:00
Earl Warren
fb303e8a04
COC: link to the moderation team 2023-12-27 18:35:08 +01:00
Earl Warren
3d6043316f
[CI] the branch is named after the PR number 2023-12-27 18:34:38 +01:00
Earl Warren
91c2dcd702
[CI] checkout the head of the PR 2023-12-27 18:22:50 +01:00
Earl Warren
23e8feae22
developer: link to the governance repository 2023-12-26 14:20:05 +01:00
Earl Warren
55dedc4ba6 developer: link to the governance repository 2023-12-25 23:29:41 +00:00
Earl Warren
3d8dae047b
GITHUB_REF_NAME is different from the PR number depending 2023-12-26 00:24:53 +01:00
Earl Warren
0538ec1a01
previews are now available on forked pull requests as well 2023-12-25 23:59:02 +01:00
Earl Warren
1caecddf18
{developer,user}: next.forgejo.org: update with the new location 2023-12-25 20:35:53 +01:00
Popolon
a58c11744a typo in systemctl 2023-12-24 22:42:12 +00:00
Earl Warren
c127ac6b59
developer: workflow: explain how to run end-to-end tests
Also fixes a few typos.
2023-12-21 17:02:15 +01:00
Earl Warren
10d2156c6e
developer: infrastructure: next.forgejo.org needs rm of the container 2023-12-18 21:36:00 +01:00
Paul Sargent
96f4c063f1 Arch Linux migration process (#298)
Add a description of the steps necessary to migrate a Gitea installation to Forgejo on Arch Linux using the native packages.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/298
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: Paul Sargent <psarge@gmail.com>
Co-committed-by: Paul Sargent <psarge@gmail.com>
2023-12-18 15:14:55 +00:00
Earl Warren
b311e9f8c4 admin: actions: s/forgejo-runners/myrunner/ 2023-12-18 11:50:14 +00:00
Earl Warren
1afd0a4ef7 developer: infrastructure: quote commands
so that copy/pasting does not get non-ascii characters
2023-12-15 21:39:47 +00:00
Earl Warren
301f4b65f5
developer: release: renewal of the release key 2023-12-15 18:53:20 +01:00
teutat3s
1886c54138 admin: actions: br-+ should be a trusted interfaces
in the NixOS firewall for actions cache to work with docker runners
2023-12-14 10:39:05 +00:00
teutat3s
42470f7ab3
user: actions: zstd is a dependency for the runner
cache extract / restore step

Fixes: #307
2023-12-13 02:26:16 +01:00
Earl Warren
64bdcbbb48
developer: infrastructure: no trailing / in reverse proxy 2023-12-12 11:58:52 +01:00
Earl Warren
691d8890cf
developer: infrastructure: hetzner{02,03} root file system backups
No information in the root filesystem is really worth saving as it
can be recreated from this documentation or even from scratch manually
if needs be. But it is cheap to keep that backup and it is worth the
effort if it can save a few hours of work when an accident happen.

The more sophisticated way to do it would be to setup DRBD with the
root file system. But this is not straightforward and to ensure it
won't get the admin in trouble when an accident happen is tricky. It
is the one time when every bit of complication can quickly become a
blocker or an unecessary burden.
2023-12-11 23:59:04 +01:00
Earl Warren
c6f7b3f688 developer: infrastructure: code.forgejo.org rotating backups 2023-12-11 22:16:03 +00:00
Earl Warren
13b6b38939
developer: infrastructure: next.forgejo.org
next.forgejo.org has been lagging for a few weeks in upgrades. While
crystal and dachary are busy, I setup and documented an LXC container
on the machine to which we all have access. It can be switched back to
where it was by updating the DNS entry.
2023-12-11 22:57:43 +01:00
Earl Warren
8058edc2a0
developer: infrastructure: IP & port forwarding 2023-12-10 14:48:45 +01:00
Earl Warren
0ab4028535 user: actions: automatic tokens do not trigger workflows 2023-12-10 11:28:25 +00:00
Antonin Delpeuch
bc5268061f Change link for Emacs' go mode 2023-12-09 22:46:22 +00:00
Antonin Delpeuch
143454ae94 Remove trailing lines 2023-12-09 22:46:22 +00:00
Antonin Delpeuch
eda0ec8443 Remove GoLand 2023-12-09 22:46:22 +00:00
Antonin Delpeuch
b8e37e4237 Add page to document how to set up a dev environment 2023-12-09 22:46:22 +00:00
Earl Warren
54a3207eb3
admin: search-engines: be precise about where to find CustomPath 2023-12-08 20:31:28 +01:00
Harald Kirsch
ade42a313d adds warning to avoid superfluous https: prefix when using npm registry 2023-12-08 20:14:40 +01:00
Earl Warren
0ed1f6d471 admin: SEND_NOTIFICATION_EMAIL_ON_NEW_USER needs ENABLE_NOTIFY_MAIL 2023-12-06 21:34:30 +00:00
Earl Warren
79266be552
admin: email: proofread and add links 2023-12-06 17:50:13 +01:00
Earl Warren
d2daf216e5 developer: infrastructure: document forgejo-helm runner
It is special because it needs extended permissions to run k8s tests.
2023-12-06 16:31:54 +00:00
Otto Richter
397b83a88c Correct default license list
Actually match the file names in option/license.
Also see https://codeberg.org/forgejo/forgejo/pulls/1888
2023-12-05 22:06:43 +00:00
Earl Warren
69a63cea19
developer: infrastructure at hetzner
* document the current setup at hetzner01 and maintenance procedures
* document the new hardware setup at hetzner{02,03} for hosting code.forgejo.org
2023-12-05 22:36:09 +01:00
Earl Warren
a1ead9463a developer: release: fix typo 2023-12-04 18:01:04 +00:00
s3lph
ac62015231 {user,admin}: actions: IPv6-capable Forgejo Runner
Preview

* Admin https://forgejo.codeberg.page/@docs_pull_243/docs/v1.21/admin/actions/
* User https://forgejo.codeberg.page/@docs_pull_243/docs/v1.21/user/actions/#execution-of-the-workflows

---

Forgejo runner receives IPv6 support in https://code.forgejo.org/forgejo/runner/pulls/120. I was requested in https://code.forgejo.org/forgejo/runner/issues/119#issuecomment-3289 to provide documentation for this feature.

Reviewed-on: https://codeberg.org/forgejo/docs/pulls/243
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: s3lph <codeberg@s3lph.me>
Co-committed-by: s3lph <codeberg@s3lph.me>
2023-12-04 17:42:08 +00:00
Antonin Delpeuch
34791eb810 Document Docker build procedure
Closes #241.
2023-12-04 10:53:54 +00:00
oliverpool
d1cfdbc9b1 Revert "developer: release: maintenance policy"
This reverts commit 506e3961d8.
2023-11-30 16:21:34 +01:00
oliverpool
b5cdc78e0c admin: release life cycle 2023-11-30 16:00:29 +01:00
oliverpool
eee441b0bb fix number of versions per year 2023-11-29 17:48:05 +00:00
oliverpool
ac4ae83940 s/unstable/experimental 2023-11-29 17:48:05 +00:00
oliverpool
ba7ac6659b developer: release: maintenance policy 2023-11-29 17:48:05 +00:00