summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorSimon Belbeoch <[email protected]>2020-05-24 16:59:45 +0200
committerGitHub <[email protected]>2020-05-24 10:59:45 -0400
commit809a5d489700f166105699aba2380085dc0066b2 (patch)
tree2dfb12df9f7de59806507b6d90f7ca45ae1deafc
parentece58af5c7e0163aa6a6c40dbe971648099cefd9 (diff)
downloadcaprover-one-click-apps-809a5d489700f166105699aba2380085dc0066b2.tar.gz
caprover-one-click-apps-809a5d489700f166105699aba2380085dc0066b2.zip
proposition of updating readme (#177)
* proposition of updating readme adding bold for clicable sections rename enviromental into environment add the icon to the process fix link name of the app who does not match with the current README * take into account dev review + important Note
-rw-r--r--README.md12
1 files changed, 6 insertions, 6 deletions
diff --git a/README.md b/README.md
index ae09040..34732a3 100644
--- a/README.md
+++ b/README.md
@@ -6,17 +6,17 @@ Process:
- Copy the content into the one-click app structure. See this for the reference: [wordpress.json](https://github.com/caprover/one-click-apps/blob/master/public/v2/apps/wordpress.json)
- Variables are prefixed with `$$cap`
- Variables can be anywhere in the JSON and they will be replaced by what user enters
-- There are 2 special variables called `$$cap_appname` and `$$cap_root_domain` which exist for all oneclick apps. If your app needs an enviromental variable that needs to point to the URL of the app, you can use `$$cap_appname.$$cap_root_domain` which resolves to something like `myappname.rootdomain.com`
-- Each custom variable must have `id`, `label`. They may also have `defaultValue`, `validRegex`, `description`.
+- There are 2 special variables called `$$cap_appname` and `$$cap_root_domain` which exist for all oneclick apps. If your app needs environment variables with the URL value of the app, you can use `$$cap_appname.$$cap_root_domain` which resolves to something like `myappname.rootdomain.com`
+- Each custom variable must have `id`, `label`. They may also have `defaultValue`, `validRegex`, `description`. (NB: fields are not required. If validRegex is not set, the field can be set as empty and ignored by the user.)
- Other than `image`, `environment`, `ports`, `volumes`, `depends_on`, other parameters are currently being ignored by CapRover. Make sure they are not crucial.
- Instead of `image` property in a service, you can use `dockerfileLines` which is an array of strings.
- Some webapps, use a non-standard HTTP port. For example, Adminer's Docker image uses port 8080. In this case, add `containerHttpPort` to the service. See [adminer.json](https://github.com/caprover/one-click-apps/blob/master/public/v2/apps/adminer.json) for example.
-
+- Add the icon as a png file to the logos directory.
## Test your One Click Apps
After creating your One-Click app json, like [this](https://github.com/caprover/one-click-apps/blob/master/public/v2/apps/adminer.json), you need to test it before creating a Pull Request. Here is how you test it:
- Login to your CapRover dashboard
-- Go to apps and click on Create One Click App
-- Select the last option from the dropdown list "TEMPLATE"
-- Copy and paste your JSON there, and click NEXT.
+- Go to **apps** and click on **One-Click Apps/Databases**
+- Select **>> TEMPLATE <<** at the bottom of the dropdown list
+- Copy and paste your JSON into the text area, and click **NEXT**.
- Enter values and make sure it's working as expected.