Merge pull request #115 from YunoHost/improve-explanation-about-service-add-flags

Improve comments about extra flags for service add
This commit is contained in:
Alexandre Aubin 2020-05-23 19:10:04 +02:00 committed by GitHub
commit 64a9cadafd
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -301,13 +301,22 @@ ynh_use_logrotate
yunohost service add $app --description "A short description of the app" --log "/var/log/$app/$app.log" yunohost service add $app --description "A short description of the app" --log "/var/log/$app/$app.log"
### With YunoHost 3.8 you will then be able to: ### Additional options starting with 3.8:
### - specify a list of ports that needs to be publicly exposed (c.f. --needs_exposed_ports) ###
### which will then be checked by YunoHost's diagnosis system ### --needs_exposed_ports "$port" a list of ports that needs to be publicly exposed
### - specify a custom command to check the status of the service (c.f. --test_status) ### which will then be checked by YunoHost's diagnosis system
### though it's only needed for weird cases where 'systemctl status' doesn't do a good job ### (N.B. DO NOT USE THIS is the port is only internal !!!)
### - specify a custom command to check / validate the configuration of the service (c.f. --test_conf) ###
### for example, the command to check the configuration of nginx is "nginx -t" ### --test_status "some command" a custom command to check the status of the service
### (only relevant if 'systemctl status' doesn't do a good job)
###
### --test_conf "some command" some command similar to "nginx -t" that validates the conf of the service
###
### Re-calling 'yunohost service add' during the upgrade script is the right way
### to proceed if you later realize that you need to enable some flags that
### weren't enabled on old installs (be careful it'll override the existing
### service though so you should re-provide all relevant flags when doing so)
###
#================================================= #=================================================
# START SYSTEMD SERVICE # START SYSTEMD SERVICE