docs(values, readme) add annotations for top-level app.ini settings
This commit is contained in:
alexandra catalina
parent
e07a0e46fc
commit
88d8ccf835
2 changed files with 215 additions and 61 deletions
85
README.md
85
README.md
|
|
@ -989,26 +989,71 @@ To comply with the Forgejo helm chart definition of the digest parameter, a "cus
|
|||
|
||||
### Gitea
|
||||
|
||||
| Name | Description | Value |
|
||||
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
|
||||
| `gitea.admin.username` | Username for the Forgejo admin user | `gitea_admin` |
|
||||
| `gitea.admin.existingSecret` | Use an existing secret to store admin user credentials | `nil` |
|
||||
| `gitea.admin.password` | Password for the Forgejo admin user | `r8sA8CPHD9!bt6d` |
|
||||
| `gitea.admin.email` | Email for the Forgejo admin user | `gitea@local.domain` |
|
||||
| `gitea.metrics.enabled` | Enable Forgejo metrics | `false` |
|
||||
| `gitea.metrics.serviceMonitor.enabled` | Enable Forgejo metrics service monitor | `false` |
|
||||
| `gitea.ldap` | LDAP configuration | `[]` |
|
||||
| `gitea.oauth` | OAuth configuration | `[]` |
|
||||
| `gitea.config.APP_NAME` | Application name, used in the page title. | `Forgejo: Beyond coding. We forge.` |
|
||||
| `gitea.config.RUN_MODE` | Application run mode, affects performance and debugging: `dev` or `prod` | `prod` |
|
||||
| `gitea.config.repository.SCRIPT_TYPE` | Script type this server supports | `bash` |
|
||||
| `gitea.config.server.SSH_PORT` | SSH port for rootlful Forgejo image | `22` |
|
||||
| `gitea.config.server.SSH_LISTEN_PORT` | SSH port for rootless Forgejo image | `2222` |
|
||||
| `gitea.config.security.PASSWORD_COMPLEXITY` | Comma separated list of character classes required to pass minimum complexity. If left empty or no valid values are specified, checking is disabled (off) | `off` |
|
||||
| `gitea.additionalConfigSources` | Additional configuration from secret or configmap | `[]` |
|
||||
| `gitea.additionalConfigFromEnvs` | Additional configuration sources from environment variables | `[]` |
|
||||
| `gitea.podAnnotations` | Annotations for the Forgejo pod | `{}` |
|
||||
| `gitea.ssh.logLevel` | Configure OpenSSH's log level. Only available for root-based Forgejo image. | `INFO` |
|
||||
| Name | Description | Value |
|
||||
| -------------------------------------- | --------------------------------------------------------------------------- | -------------------- |
|
||||
| `gitea.admin.username` | Username for the Forgejo admin user | `gitea_admin` |
|
||||
| `gitea.admin.existingSecret` | Use an existing secret to store admin user credentials | `nil` |
|
||||
| `gitea.admin.password` | Password for the Forgejo admin user | `r8sA8CPHD9!bt6d` |
|
||||
| `gitea.admin.email` | Email for the Forgejo admin user | `gitea@local.domain` |
|
||||
| `gitea.metrics.enabled` | Enable Forgejo metrics | `false` |
|
||||
| `gitea.metrics.serviceMonitor.enabled` | Enable Forgejo metrics service monitor | `false` |
|
||||
| `gitea.ldap` | LDAP configuration | `[]` |
|
||||
| `gitea.oauth` | OAuth configuration | `[]` |
|
||||
| `gitea.additionalConfigSources` | Additional configuration from secret or configmap | `[]` |
|
||||
| `gitea.additionalConfigFromEnvs` | Additional configuration sources from environment variables | `[]` |
|
||||
| `gitea.podAnnotations` | Annotations for the Forgejo pod | `{}` |
|
||||
| `gitea.ssh.logLevel` | Configure OpenSSH's log level. Only available for root-based Forgejo image. | `INFO` |
|
||||
|
||||
### `app.ini` overrides ([full list](https://forgejo.org/docs/latest/admin/config-cheat-sheet/))
|
||||
|
||||
| Name | Description | Value |
|
||||
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
|
||||
| `gitea.config.APP_NAME` | Application name, used in the page title. | `Forgejo: Beyond coding. We forge.` |
|
||||
| `gitea.config.RUN_MODE` | Application run mode, affects performance and debugging: `dev` or `prod` | `prod` |
|
||||
| `gitea.config.repository` | General repository settings | `{}` |
|
||||
| `gitea.config.cors` | Cross-origin resource sharing settings | `{}` |
|
||||
| `gitea.config.ui` | User interface settings | `{}` |
|
||||
| `gitea.config.markdown` | Markdown parser settings | `{}` |
|
||||
| `gitea.config.server` | General server settings | `{}` |
|
||||
| `gitea.config.database` | Database configuration (only necessary with an [externally managed DB](https://codeberg.org/forgejo-contrib/forgejo-helm#external-database)). | `{}` |
|
||||
| `gitea.config.indexer` | Settings for what content is indexed and how | `{}` |
|
||||
| `gitea.config.queue` | Job queue configuration | `{}` |
|
||||
| `gitea.config.admin` | Admin user settings | `{}` |
|
||||
| `gitea.config.security` | Site security settings | `{}` |
|
||||
| `gitea.config.camo` | Settings for the [camo](https://github.com/cactus/go-camo) media proxy server (disabled by default) | `{}` |
|
||||
| `gitea.config.openid` | Configuration for authentication with OpenID (disabled by default) | `{}` |
|
||||
| `gitea.config.oauth2_client` | OAuth2 client settings | `{}` |
|
||||
| `gitea.config.service` | Configuration for miscellaneous Forgejo services | `{}` |
|
||||
| `gitea.config.ssh` | SSH key requirements | `{}` |
|
||||
| `gitea.config.webhook` | Webhook settings | `{}` |
|
||||
| `gitea.config.mailer` | Mailer configuration (disabled by default) | `{}` |
|
||||
| `gitea.config.email.incoming` | Configuration for handling incoming mail (disabled by default) | `{}` |
|
||||
| `gitea.config.cache` | Cache configuration | `{}` |
|
||||
| `gitea.config.session` | Session/cookie handling | `{}` |
|
||||
| `gitea.config.picture` | User avatar settings | `{}` |
|
||||
| `gitea.config.project` | Project board defaults | `{}` |
|
||||
| `gitea.config.attachment` | Issue and PR attachment configuration | `{}` |
|
||||
| `gitea.config.log` | Logging configuration | `{}` |
|
||||
| `gitea.config.cron` | Cron job configuration | `{}` |
|
||||
| `gitea.config.git` | Global settings for Git | `{}` |
|
||||
| `gitea.config.metrics` | Settings for the Prometheus endpoint (disabled by default) | `{}` |
|
||||
| `gitea.config.api` | Settings for the Swagger API documentation endpoints | `{}` |
|
||||
| `gitea.config.oauth2` | Settings for the [OAuth2 provider](https://forgejo.org/docs/latest/admin/oauth2-provider/) | `{}` |
|
||||
| `gitea.config.i18n` | Internationalization settings | `{}` |
|
||||
| `gitea.config.markup` | Configuration for advanced markup processors | `{}` |
|
||||
| `gitea.config.highlight` | Syntax highlighting configuration | `{}` |
|
||||
| `gitea.config.time` | Locale settings | `{}` |
|
||||
| `gitea.config.migrations` | Settings for Git repository migrations | `{}` |
|
||||
| `gitea.config.federation` | Federation configuration | `{}` |
|
||||
| `gitea.config.packages` | Package registry settings | `{}` |
|
||||
| `gitea.config.mirror` | Configuration for repository mirroring | `{}` |
|
||||
| `gitea.config.lfs` | Large File Storage configuration | `{}` |
|
||||
| `gitea.config.repo-avatar` | Repository avatar storage configuration | `{}` |
|
||||
| `gitea.config.avatar` | User/org avatar storage configuration | `{}` |
|
||||
| `gitea.config.storage` | General storage settings | `{}` |
|
||||
| `gitea.config.proxy` | Proxy configuration (disabled by default) | `{}` |
|
||||
| `gitea.config.actions` | Configuration for [Forgejo Actions](https://forgejo.org/docs/latest/user/actions/) | `{}` |
|
||||
| `gitea.config.other` | Uncategorized configuration options | `{}` |
|
||||
|
||||
### LivenessProbe
|
||||
|
||||
|
|
|
|||
191
values.yaml
191
values.yaml
|
|
@ -391,47 +391,6 @@ gitea:
|
|||
# customProfileUrl:
|
||||
# customEmailUrl:
|
||||
|
||||
# Every value described in the [Cheat
|
||||
# Sheet](https://forgejo.org/docs/latest/admin/config-cheat-sheet/) can be set
|
||||
# as a Helm value. Configuration sections map to (lowercased) YAML blocks,
|
||||
# while the keys themselves remain in all caps.
|
||||
config:
|
||||
# values in the DEFAULT section
|
||||
# (https://forgejo.org/docs/latest/admin/config-cheat-sheet/#overall-default)
|
||||
# are un-namespaced
|
||||
|
||||
## @param gitea.config.APP_NAME Application name, used in the page title.
|
||||
APP_NAME: 'Forgejo: Beyond coding. We forge.'
|
||||
|
||||
## @param gitea.config.RUN_MODE Application run mode, affects performance and debugging: `dev` or `prod`
|
||||
RUN_MODE: prod
|
||||
|
||||
repository:
|
||||
## @param gitea.config.repository.SCRIPT_TYPE Script type this server supports
|
||||
SCRIPT_TYPE: bash
|
||||
|
||||
# if you're using an externally managed database (recommended;
|
||||
# https://codeberg.org/forgejo-contrib/forgejo-helm#external-database)
|
||||
#
|
||||
# database:
|
||||
# DB_TYPE: postgres
|
||||
# HOST: postgresql-svc
|
||||
# NAME: forgejo-db
|
||||
# USER: forgejo
|
||||
|
||||
##
|
||||
server:
|
||||
## @param gitea.config.server.SSH_PORT SSH port for rootlful Forgejo image
|
||||
SSH_PORT: 22 # rootful image
|
||||
|
||||
## @param gitea.config.server.SSH_LISTEN_PORT SSH port for rootless Forgejo image
|
||||
SSH_LISTEN_PORT: 2222 # rootless image
|
||||
|
||||
##
|
||||
security:
|
||||
## @param gitea.config.security.PASSWORD_COMPLEXITY Comma separated list of character classes required to pass minimum complexity. If left empty or no valid values are specified, checking is disabled (off)
|
||||
PASSWORD_COMPLEXITY: 'off'
|
||||
|
||||
## @param gitea.additionalConfigSources Additional configuration from secret or configmap
|
||||
additionalConfigSources: []
|
||||
# - secret:
|
||||
|
|
@ -449,6 +408,156 @@ gitea:
|
|||
ssh:
|
||||
logLevel: 'INFO'
|
||||
|
||||
# Every value described in the [Cheat
|
||||
# Sheet](https://forgejo.org/docs/latest/admin/config-cheat-sheet/) can be set
|
||||
# as a Helm value. Configuration sections map to (lowercased) YAML blocks,
|
||||
# while the keys themselves remain in all caps.
|
||||
#
|
||||
## @section `app.ini` overrides ([full list](https://forgejo.org/docs/latest/admin/config-cheat-sheet/))
|
||||
config:
|
||||
# values in the DEFAULT section
|
||||
# (https://forgejo.org/docs/latest/admin/config-cheat-sheet/#overall-default)
|
||||
# are un-namespaced
|
||||
|
||||
## @param gitea.config.APP_NAME Application name, used in the page title.
|
||||
APP_NAME: 'Forgejo: Beyond coding. We forge.'
|
||||
|
||||
## @param gitea.config.RUN_MODE Application run mode, affects performance and debugging: `dev` or `prod`
|
||||
RUN_MODE: prod
|
||||
|
||||
## @param gitea.config.repository General repository settings
|
||||
repository: {}
|
||||
|
||||
## @param gitea.config.cors Cross-origin resource sharing settings
|
||||
cors: {}
|
||||
|
||||
## @param gitea.config.ui User interface settings
|
||||
ui: {}
|
||||
|
||||
## @param gitea.config.markdown Markdown parser settings
|
||||
markdown: {}
|
||||
|
||||
## @param gitea.config.server General server settings
|
||||
server: {}
|
||||
|
||||
## @param gitea.config.database Database configuration (only necessary with an [externally managed DB](https://codeberg.org/forgejo-contrib/forgejo-helm#external-database)).
|
||||
database: {}
|
||||
|
||||
## @param gitea.config.indexer Settings for what content is indexed and how
|
||||
indexer: {}
|
||||
|
||||
## @param gitea.config.queue Job queue configuration
|
||||
queue: {}
|
||||
|
||||
## @param gitea.config.admin Admin user settings
|
||||
admin: {}
|
||||
|
||||
## @param gitea.config.security Site security settings
|
||||
security: {}
|
||||
|
||||
## @param gitea.config.camo Settings for the [camo](https://github.com/cactus/go-camo) media proxy server (disabled by default)
|
||||
camo: {}
|
||||
|
||||
## @param gitea.config.openid Configuration for authentication with OpenID (disabled by default)
|
||||
openid: {}
|
||||
|
||||
## @param gitea.config.oauth2_client OAuth2 client settings
|
||||
oauth2_client: {}
|
||||
|
||||
## @param gitea.config.service Configuration for miscellaneous Forgejo services
|
||||
service: {}
|
||||
|
||||
## @param gitea.config.ssh SSH key requirements
|
||||
ssh: {}
|
||||
|
||||
## @param gitea.config.webhook Webhook settings
|
||||
webhook: {}
|
||||
|
||||
## @param gitea.config.mailer Mailer configuration (disabled by default)
|
||||
mailer: {}
|
||||
|
||||
## @param gitea.config.email.incoming Configuration for handling incoming mail (disabled by default)
|
||||
email:
|
||||
incoming: {}
|
||||
|
||||
## @param gitea.config.cache Cache configuration
|
||||
cache: {}
|
||||
|
||||
## @param gitea.config.session Session/cookie handling
|
||||
session: {}
|
||||
|
||||
## @param gitea.config.picture User avatar settings
|
||||
picture: {}
|
||||
|
||||
## @param gitea.config.project Project board defaults
|
||||
project: {}
|
||||
|
||||
## @param gitea.config.attachment Issue and PR attachment configuration
|
||||
attachment: {}
|
||||
|
||||
## @param gitea.config.log Logging configuration
|
||||
log: {}
|
||||
|
||||
## @param gitea.config.cron Cron job configuration
|
||||
cron: {}
|
||||
|
||||
## @param gitea.config.git Global settings for Git
|
||||
git: {}
|
||||
|
||||
## @param gitea.config.metrics Settings for the Prometheus endpoint (disabled by default)
|
||||
metrics: {}
|
||||
|
||||
## @param gitea.config.api Settings for the Swagger API documentation endpoints
|
||||
api: {}
|
||||
|
||||
## @param gitea.config.oauth2 Settings for the [OAuth2 provider](https://forgejo.org/docs/latest/admin/oauth2-provider/)
|
||||
oauth2: {}
|
||||
|
||||
## @param gitea.config.i18n Internationalization settings
|
||||
i18n: {}
|
||||
|
||||
## @param gitea.config.markup Configuration for advanced markup processors
|
||||
markup: {}
|
||||
|
||||
## @param gitea.config.highlight Syntax highlighting configuration
|
||||
highlight: {}
|
||||
|
||||
## @param gitea.config.time Locale settings
|
||||
time: {}
|
||||
|
||||
## @param gitea.config.migrations Settings for Git repository migrations
|
||||
migrations: {}
|
||||
|
||||
## @param gitea.config.federation Federation configuration
|
||||
federation: {}
|
||||
|
||||
## @param gitea.config.packages Package registry settings
|
||||
packages: {}
|
||||
|
||||
## @param gitea.config.mirror Configuration for repository mirroring
|
||||
mirror: {}
|
||||
|
||||
## @param gitea.config.lfs Large File Storage configuration
|
||||
lfs: {}
|
||||
|
||||
## @param gitea.config.repo-avatar Repository avatar storage configuration
|
||||
repo-avatar: {}
|
||||
|
||||
## @param gitea.config.avatar User/org avatar storage configuration
|
||||
avatar: {}
|
||||
|
||||
## @param gitea.config.storage General storage settings
|
||||
storage: {}
|
||||
|
||||
## @param gitea.config.proxy Proxy configuration (disabled by default)
|
||||
proxy: {}
|
||||
|
||||
## @param gitea.config.actions Configuration for [Forgejo Actions](https://forgejo.org/docs/latest/user/actions/)
|
||||
actions: {}
|
||||
|
||||
## @param gitea.config.other Uncategorized configuration options
|
||||
other: {}
|
||||
|
||||
## @section LivenessProbe
|
||||
#
|
||||
## @param gitea.livenessProbe.enabled Enable liveness probe
|
||||
|
|
|
|||
Loading…
Reference in a new issue