aboutsummaryrefslogtreecommitdiff
path: root/doc/forge.skb
AgeCommit message (Expand)Author
2024-04-11doc: Explicitly identify gunicorn service subsection.•••* doc/forge.skb (Services)[Specialized application deployment services]{gunicorn service}: Add identifier. Arun Isaac
2024-04-11gunicorn: Support unstructured extra CLI arguments.•••The most useful options (e.g. "--workers", "--timeout", "--env") have dedicated slots in the <gunicorn-app> structure. These, however, are not the only options available to pass to gunicorn at startup. This commit allows us to pass in a list of any extra CLI options we want on the CLI. * guix/forge/gunicorn.scm (<gunicorn-app>)[extra-cli-arguments]: New field. (gunicorn-shepherd-services): Use extra-cli-arguments field. * doc/forge.skb (Services)[Specialized application deployment services]{gunicorn service}<gunicorn-app>: Document extra-cli-arguments field. Signed-off-by: Arun Isaac <arunisaac@systemreboot.net> Frederick M. Muriithi
2024-01-09forge: Limit number of parallel CI job runs.•••* guix/forge/forge.scm (<forge-project>)[parallel-ci-job-runs]: New field. * guix/forge/forge.scm (forge-ci-jobs): Add project context to CI jobs. (forge-ci-job-contexts): New function. (forge-ci-jobs-and-groups): Rename to forge-ci-jobs+contexts+groups. Also return <forge-laminar-context> objects. (forge-service-type): Call forge-ci-jobs+contexts+groups instead of forge-ci-jobs-and-groups. * doc/forge.skb (Reference)[<forge-project>]{parallel-ci-job-runs}: Document it. Arun Isaac
2024-01-09laminar: Allow associating contexts to jobs.•••* guix/forge/laminar.scm (<forge-laminar-job>)[contexts]: New field. * guix/forge/laminar.scm (laminar-jobs): Create job configuration file specifying contexts. * doc/forge.skb (Reference)[<forge-laminar-job>]{contexts}: Document it. Arun Isaac
2024-01-08gunicorn: Support worker timeout parameter.•••* guix/forge/gunicorn.scm (<gunicorn-app>)[timeout]: New field. * guix/forge/gunicorn.scm (gunicorn-shepherd-services): Pass --timeout parameter. * doc/forge.skb (Reference)[Specialized application deployment services]{gunicorn service}<gunicorn-app>: Document timeout field. Arun Isaac
2023-12-22fcgiwrap: Use <environment-variable> records.•••* guix/forge/fcgiwrap.scm: Import (forge environment). (fcgiwrap-shepherd-services): Use <environment-variable> record. * doc/forge.skb (Services)[Specialized application deployment services]{fcgiwrap service}: Document it. * guix/forge/cgit.scm: Import (forge environment). (cgit-fcgiwrap-instance): Use <environment-variable> record. Arun Isaac
2023-12-22gunicorn: Use <environment-variable> records.•••* guix/forge/gunicorn.scm: Import (forge environment). (gunicorn-shepherd-services): Use <environment-variable> record. * doc/forge.skb (Services)[Specialized application deployment services]{gunicorn service}: Document it. * guix/forge/klaus.scm: Import (forge environment). (klaus-gunicorn-app): Use <environment-variable> record. Arun Isaac
2023-12-22environment: Introduce record type for environment variables.•••* guix/forge/environment.scm: New file. * doc/forge.skb (Reference)[<environment-variable>]: Document it. Arun Isaac
2023-10-04doc: Note disregard of description field for remote repositories.•••* doc/forge.skb (Reference)[<forge-project>]{description}: Note that this field is disregarded for remote repositories. v0.1.0Arun Isaac
2023-08-15doc: Advertise ACME support.•••* doc/forge.skb (Introduction), website/index.skb: Advertise ACME support. Arun Isaac
2023-08-15doc: Advertise support for cgit and klaus.•••* doc/forge.skb (Introduction), website/index.skb: Advertise support for cgit and klaus. Arun Isaac
2023-08-15doc: Remind about the ACME state directory in persistent storage.•••* doc/forge.skb (How To)[How to set up cgit]: Remind about putting the ACME state directory in persistent storage. Arun Isaac
2023-08-14doc: Mention that cgit runs in a container in how to.•••* doc/forge.skb (How To)[How to set up cgit]: Mention that cgit runs in a container. Arun Isaac
2023-08-14doc: Add cgit setup how to.•••* doc/forge.skb (How To): New chapter. * doc/snippets/acme-staging-url.scm, doc/snippets/how-to-set-up-cgit.scm: New files. * tissue.scm (#:indexed-documents): Index chapter-how-to. Arun Isaac
2023-08-12doc: Clarify that README files for cgit must be in the default branch.•••* doc/forge.skb (Services)[Git web viewers]{cgit service}: Clarify that README files are looked up in the default branch. Arun Isaac
2023-08-12doc: Spell viewer correctly.•••* doc/forge.skb (Services)[Git web viewers]: Spell viewer correctly. Arun Isaac
2023-08-12cgit: Render org mode README files.•••* guix/forge/cgit.scm: Import emacs-minimal from (gnu packages emacs). (%cgit-readme): Add README.org. (about-filter-gexp): Render org mode README files. * guix/forge/org2html.el: New file. * doc/forge.skb (Services)[Git web viewers]{cgit service}: Document support for org mode README files. Arun Isaac
2023-08-10doc: Move gunicorn service documentation to Services chapter.•••* doc/forge.skb (Reference): Move gunicorn service documentation to ... (Services)[Specialized application deployment services]{gunicorn service}: ... new subsection. Arun Isaac
2023-08-10doc: Capitalize HTML.•••* doc/forge.skb (Services)[Git web viewers]{cgit service}: Capitalize HTML. Arun Isaac
2023-08-10doc: Distinguish cgit service from upstream cgit service.•••* doc/forge.skb (Services)[Git web viewers]{cgit service}: Distinguish from upstream cgit service. Arun Isaac
2023-08-10doc: Mention reStructuredText as a supported README file in cgit.•••* doc/forge.skb (Services)[Git web viewers]{cgit service}: Mention reStructuredText as a supported README file. Arun Isaac
2023-08-10doc: Fix spelling cloneable -> clonable.•••* doc/forge.skb (Services)[Git web viewers]{cgit service}: Fix spelling cloneable -> clonable. Arun Isaac
2023-08-09doc: List subsections in table of contents.•••* doc/forge.skb: List subsections in table of contents. Arun Isaac
2023-08-09doc: Remove trailing period at end of phrase.•••* doc/forge.skb (Reference)[gunicorn-app]: Remove trailing period at the end of mappings documentation phrase. Arun Isaac
2023-08-09gunicorn: Support <forge-host-socket> sockets.•••* guix/forge/gunicorn.scm (socket->gunicorn-bind): Support <forge-host-socket> sockets. * doc/forge.skb (Reference): Document it. Arun Isaac
2023-08-09cgit: Add cgit service.•••* guix/forge/cgit.scm: New file. * doc/forge.skb (Services)[Git web viewers]: New section. Arun Isaac
2023-08-09fcgiwrap: Add fcgiwrap service.•••* guix/forge/fcgiwrap.scm: New file. * doc/forge.skb (Services)[Specialized application deployment services]: New section. Arun Isaac
2023-08-09nginx: Add forge-nginx service.•••* guix/forge/nginx.scm, doc/snippets/acme-restart-nginx-sudoers.scm: New files. * doc/forge.skb (Services)[forge nginx service]: Document the forge-nginx service. Arun Isaac
2023-08-09acme: Add ACME service.•••* guix/forge/acme.scm: Import shadow from (gnu packages admin), nss-certs from (gnu packages certs), (gnu services), (gnu services mcron), (gnu system shadow), (guix diagnostics), (guix i18n), (guix profiles), (guix records), (srfi srfi-1) and (ice-9 match). (%letsencrypt-production-url, %letsencrypt-staging-url): New variables. (<acme-configuration>, <acme-rsa-key>, <acme-ecdsa-key>, <acme-certificate>): New record types. (acme-http-01-webroot-authorization-hook, acme-http-01-webroot-cleanup-hook): New public functions. (acme-key-length, uacme-hook, acme-activation, acme-renew, acme-helper, acme-helper-sudo-wrapper, acme-special-files, acme-cron-job, raise-to-top): New functions. (%acme-accounts, acme-service-type): New variables. * doc/forge.skb (Services)[ACME service]: New section. Arun Isaac
2023-08-09doc: Add record-ref convenience function.•••* doc/skribilo.scm (record-ref): New public function. * doc/forge.skb: Use record-ref. Arun Isaac
2023-08-08socket: Introduce <forge-host-socket>.•••* guix/forge/socket.scm (<forge-host-socket>): New record type. * doc/forge.skb (Reference): Document <forge-host-socket>. Arun Isaac
2023-07-25klaus: Add helper function to create klaus gunicorn app.•••* guix/forge/klaus.scm: Import (forge gunicorn) and (gnu system file-systems). (klaus-gunicorn-app): New public function. * doc/forge.skb (Introduction): Advertise klaus support. (Reference): Document klaus-gunicorn-app. Arun Isaac
2023-07-25gunicorn: Add gunicorn service.•••* guix/forge/gunicorn.scm: New file. * doc/forge.skb (Reference): Document <gunicorn-configuration> and <gunicorn-app>. Arun Isaac
2023-03-09doc: Explain with-imported-modules and use-modules.•••* doc/forge.skb (Tutorial): Explain why both with-imported-modules and use-modules are necessary. Arun Isaac
2023-02-03doc: Identify chapters.•••* doc/forge.skb: Identify each chapter with a unique identifier. Arun Isaac
2022-10-17webhook: Use <forge-*-socket> to configure socket.•••* doc/forge.skb (Reference)[<webhook-configuration>]: Replace ip and port fields with the socket field. * guix/forge/webhook.scm: Import (forge socket). (<webhook-configuration>): Replace ip and port fields with the socket field. (webhook-shepherd-service): Reference the socket field instead of the ip and port fields. Arun Isaac
2022-07-05socket: Introduce <forge-*-socket> types.•••<forge-*-socket> will be a universal type to specify IP addresses, ports and Unix sockets across all guix-forge services. * guix/forge/socket.scm: New file. * doc/forge.skb (Reference): Document <forge-ip-socket> and <forge-unix-socket>. Arun Isaac
2022-06-01doc: Label file as post-receive, instead of post-receive-hook.•••* doc/forge.skb (Tutorial, Reference): Label file as post-receive, instead of post-receive-hook. Arun Isaac
2022-06-01doc: Move comma displaced by Emacs lispy-mode.•••* doc/forge.skb (Reference): Move comma displaced by Emacs lispy mode. Arun Isaac
2022-04-08doc: Link to ci-jobs-trigger-gexp definition.•••* doc/forge.skb (Tutorial): Link mention of post-receive-hook script to the in-source definition of ci-jobs-trigger-gexp. Arun Isaac
2022-03-28forge: Add trigger? field to forge-laminar-job.•••* guix/forge/laminar.scm (<forge-laminar-job>)[trigger?]: New field. * guix/forge/forge.scm (ci-jobs-trigger-gexp): Only trigger jobs for which trigger? is #t. * doc/forge.skb (Reference)[<forge-laminar-job>]: Document trigger?. Arun Isaac
2022-03-21doc: Explain what a post-receive-hook is and how it is set up.•••* doc/forge.skb (Tutorial): Explain what a post-receive-hook is and how it is set up. Arun Isaac
2022-03-21doc: Clarify double reference of (guix build utils).•••* doc/forge.skb (Tutorial): Clarify double reference of (guix build utils). Arun Isaac
2022-03-20doc: Link to G-expressions in the Guix manual.•••* doc/forge.skb (Tutorial): Link to G-expressions in the Guix manual. Arun Isaac
2022-03-19doc: Mention minimum configurability to philosophy.•••* README.org (Philosophy), doc/forge.skb (Introduction)[Philosophy]: Mention minimum configurability. Arun Isaac
2022-03-19doc: List software components used by guix-forge.•••* README.org, doc/forge.skb (Introduction): List software components used by guix-forge. Arun Isaac
2022-03-19forge: Change ownership of parent directory of website directory.•••* guix/forge/forge.scm (forge-activation): Change ownership of parent directory of website directory, instead of changing the ownership of the website directory itself. * doc/forge.skb (Reference)[<forge-project>]: Document it. Arun Isaac
2022-03-08doc: Reference source files inside guix directory.•••The source files are now nested one level deeper in the guix directory, and the references to the source files in the documentation need to be updated. * doc/forge.skb (Reference): Reference source files inside guix directory. Arun Isaac
2022-02-28doc: Add Tutorial.•••* Makefile (doc_snippets): New variable. ($(doc_html)): Depend on $(doc_snippets). * doc/forge.skb: Import (skribilo source lisp). (Tutorial): New chapter. * doc/snippets/tutorial.scm: New file. Arun Isaac
2022-02-28doc: Add table of contents.•••* doc/forge.skb: Add table of contents. Arun Isaac