This sample demonstrates how to run a containerized Java application on DigitalOcean App Platform. Since App Platform doesn't yet support Java, this sample shows how to accomplish this using Dockerfile.
This sample has been adapted from https://github.com/wkrzywiec/Nasa-Picture and simply calls an API to show the NASA picture of the day.
These steps will get this sample application running for you using DigitalOcean.
Note: Following these steps will result in charges for the use of DigitalOcean services
- You need a DigitalOcean account. If you don't already have one, you can sign up at https://cloud.digitalocean.com/registrations/new
To use all the features of App Platform, you need to be running against your own copy of this application. To make a copy, click the Fork button above and follow the on-screen instructions. In this case, you'll be forking this repo as a starting point for your own app (see Github documentation to learn more about forking repos.
After forking the repo, you should now be viewing this README in your own github org (e.g. https://github.com/<your-org>/aspnetcoresample)
Note: You can skip forking this repo and select a sample app from the app creation page, however do notice that certain features will be disabled.
- Visit https://cloud.digitalocean.com/apps (if you're not logged in, you may see an error message. Visit https://cloud.digitalocean.com/login directly and authenticate, then try again)
- Click "Launch App" or "Create App"
- Choose GitHub and authenticate with your GitHub credentials.
- Under Repository, choose this repository (e.g.
<your-org>/aspnetcoresample) - On the next two screens, leave all the defaults unchanged.
- Click "Launch App"
- You should see a "Building..." progress indicator. And you can click "Deployments"→"Details" to see more details of the build.
- It can currently take 5-6 minutes to build this app, so please be patient. Live build logs are coming soon to provide much more feedback during deployments.
- Once the build completes successfully, click the "Live App" link in the header and you should see your running application in a new tab
As long as you left the default Autodeploy option enabled when you first launched this app, you can now make code changes and see them automatically reflected in your live application. During these automatic deployments, your application will never pause or stop serving request because the App Platform offers zero-downtime deployments.
You can learn more about the App Platform and how to manage and update your application at https://www.digitalocean.com/docs/apps/.
When you no longer need this sample application running live, you can delete it by following these steps:
- Visit the Apps control panel at https://cloud.digitalocean.com/apps
- Navigate to the sample-dockerfile app
- Choose "Settings"->"Destroy"
This will delete the app and destroy any underlying DigitalOcean resources
Note: If you don't delete your app, charges for the use of DigitalOcean services will continue to accrue.
The MIT License (MIT)
Copyright (c) 2019 Wojciech Krzywiec
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.