coop-cloud-win-deploy/md/add-1stapp-deploy.md

44 lines
2.7 KiB
Markdown

# Deploy First App to Capsul
Currently, the official catalogue of Coop-Cloud apps is at [App catalogue]( https://docs.coopcloud.tech/apps/). There's an experimental version of the catalogue in the works; you can see the link to it in the image.
![00](../res/custom-html-deploy/00.png "00")
We'll be deploying Custom HTML by following the instructions in "Basic usage" below.
![01](../res/custom-html-deploy/0.1.png "0.1")
1. Let's create a minimal HTML5 web page. Launch your WSL Linux system. Create a file called index.html. The example below uses the nano text editor.
![04](../res/custom-html-deploy/04.png "04")
1. Assuming you have previously copied basic HTML5 code into the clipboard, you can right-click the top of the Linux command window, slide down to Edit, slide over to Paste and click on it.
![05](../res/custom-html-deploy/05.png "05")
This is what nano looks like after pasting a minimal HTML5 document into it. Use Ctrl-O to save the file, and Ctrl-X to exit the nano editor.
![06](../res/custom-html-deploy/06.png "06")
1. Create the custom html app on your Capsul using Abra. The app is associated with the server named *coolstuff.ninja*. It will be listening at the domain name *coolstuff.ninja*, that is, after it is deployed, when you type https://coolstuff.ninja, you will see the minimal html5 page we've just saved in index.html. The --app-name option tells Abra to name the app *custom-html-ninj*.
> abra app new custom-html --server coolstuff.ninja --domain coolstuff.ninja --app-name custom-html-ninj
![07](../res/custom-html-deploy/07.png "07")
1. After abra finishes adding the new app, you can check out its configuration:
> abra app custom-html-ninj config
![08](../res/custom-html-deploy/08.png "08")
This opens custom-html-ninj's configuration in a text editor, and you could update any values which need to be updated. In this case, everything looks good, so we don't make any changes.
![09](../res/custom-html-deploy/09.png "09")
1. It's time to deploy the app. It's a very basic app, and so the command line to deploy it is very simple. Type 'y' to confirm the deployment. After a few moments, you should see *SUCCESS: Yay! App should be available at **domain-name***.
You need to copy the index.html file into the custom-html-ninj app.
> abra app custom-html-ninj cp index.html app:/usr/share/nginx/html
![10](../res/custom-html-deploy/10.png "10")
1. Finally, open your website using your browser. https://your-domain-name
![11](../res/custom-html-deploy/11.png "11")
You should see "This is the Title" in the page's title, and "This is the page content." on the page.
| [Previous](add-traefik-deploy.md) | [Next](finish.md) | [Top](../README.md) |