YunoHost/doc
1
0
Fork 0
mirror of https://github.com/YunoHost/doc.git synced 2024-09-03 20:06:26 +02:00
Code Issues Projects Releases Packages Wiki Activity

Fix typos

Browse source
This commit is contained in:
Éric Gaspar 2023-02-02 09:41:56 +01:00
parent d5e18cbd03
commit 40a2f96afb
1 changed files with 26 additions and 26 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
pages/06.contribute/10.packaging_apps/packaging_apps_intro.md
View file

@ -7,7 +7,7 @@ routes:
default: '/packaging_apps_intro' default: '/packaging_apps_intro'
--- ---
This documentation is here to provide all the basic concepts and vocabulary needed to understand app packaging.i This documentation is here to provide all the basic concepts and vocabulary needed to understand app packaging.
We will detail what a YunoHost application package is, how it works, how to make your own package and how to find help if you need it. We will detail what a YunoHost application package is, how it works, how to make your own package and how to find help if you need it.
@ -22,14 +22,14 @@ The ability to easily install applications from a catalog is a key feature of Yu
- **Things should work out of the box**: for example, the admin should not have to manually finish the installation process by manually filling in database credentials; - **Things should work out of the box**: for example, the admin should not have to manually finish the installation process by manually filling in database credentials;
- Yunohost app packaging is **not just about installing** sources and dependencies: it's also about maintenance (upgrade, backup, ..) and integrating the app in the YunoHost ecosystem (nginx, sso/ldap, fail2ban, application catalog, ui/ux, ...) - YunoHost app packaging is **not just about installing** sources and dependencies: it's also about maintenance (upgrade, backup...) and integrating the app in the YunoHost ecosystem (NGINX, SSO/LDAP, Fail2Ban, application catalog, UI/UX...)
## 2. Prerequisites ## 2. Prerequisites
Before diving in, this documentation assumes that: Before diving in, this documentation assumes that:
1. You already are a Yunohost admin yourself and already know what the install workflow looks like ;) 1. You already are a YunoHost admin yourself and already know what the install workflow looks like;)
2. You are somewhat familiar with (or are willing to learn) system administration and bash programming; 2. You are somewhat familiar with (or are willing to learn) system administration and bash programming;
3. You are somewhat familiar with (or are willing to learn) Git; 3. You are somewhat familiar with (or are willing to learn) Git;
4. You are comfortable with tinkering and debugging computer stuff in general. 4. You are comfortable with tinkering and debugging computer stuff in general.
@ -40,11 +40,11 @@ At some point, you will also want to have a dev/test environment, either using [
## 3. Notes about the history of YunoHost's app packaging ## 3. Notes about the history of YunoHost's app packaging
Many things in Yunohost, and Yunohost app packaging format, are historical or were designed in an organic fashion. Thus some aspects may legitimately feel old. Many things in YunoHost, and YunoHost app packaging format, are historical or were designed in an organic fashion. Thus some aspects may legitimately feel old.
The **"v0" of app packaging** consisted in writing raw bash scripts with no real standardization/constrain. The **"v0" of app packaging** consisted in writing raw bash scripts with no real standardization/constrain.
Over time, recurrent steps (such as installing dependencies with apt, or setting up the nginx config) where formalized into standardized bash functions, a.k.a "helpers". This pretty much marked **the beginning of the "v1" packaging era**. Over time, recurrent steps (such as installing dependencies with apt, or setting up the NGINX config) where formalized into standardized bash functions, aka "helpers". This pretty much marked **the beginning of the "v1" packaging era**.
Various tools were implemented to test the app and standardize their behavior. Various tools were implemented to test the app and standardize their behavior.
@ -52,10 +52,10 @@ After a while, a set of common practices and conventions emerged and is somewhat
Nevertheless, even though helpers existed, the inherent structure of apps was hard and boring to maintain with too many redundant pieces of code or filled with funky historical conventions. **A new v2 format** [has been designed and added to YunoHost 11.1 in early 2023](https://github.com/YunoHost/yunohost/pull/1289) in the hope to modernize and simplify app packaging and improve the UI/UX of YunoHost. Nevertheless, even though helpers existed, the inherent structure of apps was hard and boring to maintain with too many redundant pieces of code or filled with funky historical conventions. **A new v2 format** [has been designed and added to YunoHost 11.1 in early 2023](https://github.com/YunoHost/yunohost/pull/1289) in the hope to modernize and simplify app packaging and improve the UI/UX of YunoHost.
However, [**a future v3 format** has yet to come](https://github.com/YunoHost/issues/issues/2136) to further simplify app packaging (such as taking care of nginx/systemd/... configurations, removing the need to manually write remove/backup/restore scripts, etc ...) However, [**a future v3 format** has yet to come](https://github.com/YunoHost/issues/issues/2136) to further simplify app packaging (such as taking care of NGINX/systemd/... configurations, removing the need to manually write remove/backup/restore scripts, etc.)
## 4. General overview of a Yunohost app structure ## 4. General overview of a YunoHost app structure
A YunoHost app consists in a Git repository. We encourage you to have a look at those code repository to get familiar witch app repository structures: A YunoHost app consists in a Git repository. We encourage you to have a look at those code repository to get familiar witch app repository structures:
- the [`helloworld_ynh`](https://github.com/YunoHost-Apps/helloworld_ynh) app - the [`helloworld_ynh`](https://github.com/YunoHost-Apps/helloworld_ynh) app
@ -75,13 +75,13 @@ Among the file contained in a package, the most important ones are:
- (`change_url`): changing where the app is installed in terms of web access url - (`change_url`): changing where the app is installed in terms of web access url
- **conf/** contains a bunch of configuration templates used when installing the app. Here are some example of commonly found files: - **conf/** contains a bunch of configuration templates used when installing the app. Here are some example of commonly found files:
- `app.src`: contains the URL and checksum to downlowd the application sources - `app.src`: contains the URL and checksum to downlowd the application sources
- `nginx.conf` : the nginx (=web server) configuration template for this app - `nginx.conf`: the NGINX (=web server) configuration template for this app
- `systemd.service`: the systemd service configuration template for this app - `systemd.service`: the systemd service configuration template for this app
- `config.json/yaml/???`: the app's configuration template - `config.json/yaml/???`: the app's configuration template
Roughly speaking, the install itself generally consists of the following operations (though these may vary depending on the complexity and technologies used by the app) - not necessarily in that exact order: Roughly speaking, the install itself generally consists of the following operations (though these may vary depending on the complexity and technologies used by the app) - not necessarily in that exact order:
1. YunoHost fetches the package's git repository 1. YunoHost fetches the package's Git repository
2. YunoHost asks to the admin the install questions defined in `manifest.toml` 2. YunoHost asks to the admin the install questions defined in `manifest.toml`
3. The admin fills the form and starts the install 3. The admin fills the form and starts the install
4. YunoHost provisions a bunch of technical prerequisites (called 'resources') such as: 4. YunoHost provisions a bunch of technical prerequisites (called 'resources') such as:
@ -94,8 +94,8 @@ Roughly speaking, the install itself generally consists of the following operati
- ... - ...
5. The actual app's `install` script is ran and typically does: 5. The actual app's `install` script is ran and typically does:
- fetch and deploy the app sources - fetch and deploy the app sources
- configure the app (typically DB credentials, internal reverse-proxy port, ...) - configure the app (typically DB credentials, internal reverse-proxy port...)
- add the nginx configuration - add the NGINX configuration
- add the systemd configuration the app's daemon - add the systemd configuration the app's daemon
- starts the app daemon - starts the app daemon
- various finialization tweaks - various finialization tweaks