dataset/seed/gitea/README.md

Table of Contents

• gitea
• Synopsis
• Example
• Basic variables
• General
• Reverse proxy
• Clients configuration
• Forgejo
• Variables
• General
• Reverse proxy
• Clients configuration
• OAuth2 client
• external
• Forgejo
• Transitional family
• Requirements services
• Mandatories
• Optionals
• Dependances

Return to the list of application services.

gitea

Synopsis

Transitional package for Gitea to Forgejo.

Example

Zone names are provided as examples. Think about adapting with the value of provider_zone in configuration file.

gitea:
  applicationservice: gitea
  zones_name:
    - localdns
    - oauth2
    - postgresql
    - redis
    - reverseproxy
    - smtp
  values:
    general.revprox.revprox_client.revprox_client_external_domainnames:
      - service.example.net

Basic variables

General

Reverse proxy

Clients configuration

This family is a leadership.

Parameter	Comment
general.revprox.revprox_client.revprox_client_external_domainnames mandatory, multiple Type: domainname	Service external domain name. Example: service.example.net
general.revprox.revprox_client.revprox_client_location mandatory Type: filename	URI to route request to the correct service. Default: /

Forgejo

Git forge Forgejo.

Parameter	Comment
general.forgejo.forgejo_title mandatory Type: string	Titre de la forge. Default: Forgejo : Au-delà du développement. Nous forgeons.

Variables

General

Reverse proxy

Clients configuration

This family is a leadership.

Parameter	Comment
general.revprox.revprox_client.revprox_client_max_body_size Type: string	The maximum allowed size of the client request body.

OAuth2 client

Parameter	Comment
general.oauth2_client.oauth2_client_name mandatory Type: string	OAuth2 client name. Default: Forge Example: example
general.oauth2_client.oauth2_client_description mandatory Type: string	OAuth2 client description. Default: Forge logiciel Forgejo Example: Example description
general.oauth2_client.oauth2_client_login Type: web_address	OAuth2 URL to valid login. Default: calculated

external

Parameter	Comments
general.oauth2_client.external.oauth2_client_external mandatory, multiple Type: web_address	OAuth2 client external. Default: calculated
general.oauth2_client.external.oauth2_client_family mandatory Type: string	OAuth2 family. Default: users

Parameter	Comment
general.oauth2_client.oauth2_client_category mandatory Type: string	OAuth2 category. Default: Développement
general.oauth2_client.oauth2_client_logo mandatory Type: string	OAuth2 logo. Default: silique_note.png

Forgejo

Git forge Forgejo.

Parameter	Comment
general.forgejo.forgejo_mail_sender mandatory Type: mail	Les courriels sont envoyés à partir de cet adresse. Default: calculated Example: admin@example.net

Transitional family

Parameter	Comments
general.gitea.gitea_mail_sender Type: mail	Transitional variable, please do not use it.

Requirements services

Mandatories

• LocalDNS: DNS forwarder for local domain name.
• SMTP: Create a SMTP relay account and authorize sending email.
• ReverseProxy: Register to service to a reverse proxy server.
• Postgresql: Create account and connexion to a PostgreSQL server.
• OAuth2: Remote clients needing to verify OAuth2 account.
• Redis: Create account and connexion to a Redis server.

Optionals

• Journald: Concentrate journal messages on one host.

Dependances

• forgejo: Forgejo, a community managed lightweight code hosting solution.
  • base-fedora-38: Base information of a Fedora 38.
    • base-fedora: Base information of a Fedora.
      • systemd: Systemd, a system and service manager.
        • base-machine: Base information for a machine.
          • base: Base of all application services.
          • dns-local: DNS client with access to local zones.
          • pki-tls: Autosign PKI or Let's encrypt support for TLS certificates.
        • journald: Journald.
        • resolved: Resolved.
  • postgresql-client: Application service needs interact with a Postgresql server.
  • reverse-proxy-client: Application service needs interact with a a reverse proxy server.
  • relay-mail-client: Client SMTP.
  • redis-client: Application service needs interact with a Redis server.
    • redis-common: Redis, an in-memory data structure store.
  • oauth2-client: Application service needs interact with a Oauth2 server.