Let's setup & create your first Pergola Project in less than 5 minutes.
Pergola runs any application ( e.g. from Python, Java, R, Kotlin, C, etc. ) that comes with a valid Dockerfile.
It needs to be available in a Git repository.
And, of course, you need to have access to a Pergola platform and a personal account.
Create a Pergola Project
Go to Pergola UI and log in.
First, create a new Project. This is the wrapper around your execution environments.
Click on New Project. The screenshots show an example from Pergola's Hello World Tutorial and uses this repository: Hello World @ Git
Fill the form. You will need your git clone URL and you can assign a name to it.
Second, create a new stage. This is your first execution environment where you can run your app. Click on Create Stage
Fill the form. Choose a stage name and choose type dev
Note, you can follow exactly these steps and use our public github-repository for testing your first Pergola application.
- Pergola is ready to run your app
- But it does not yet know the resources (in other words: hardware and network) your app needs. See the next section for this.
Create a Project Manifest
The Project Manifest (pergola.yaml) is a descriptor added to your application, that tells Pergola what your app needs to be able to build and run.
The Pergola Hello World application uses this Project Manifest:
- name: hello-world-runner
This text needs to be pushed to the git repository of your app as file pergola.yaml.
Note: The Project Manifest is unobtrusive by design. Your application still runs everywhere else, not only in Pergola.
- We can start the application in Pergola now.
Build and Release the app
All preparations are done. Now, we want to run our application in Pergola.
To run the application, it first needs to be built.
Just click Build now
It might take a minute or so, but you should see a new succeeded build. Click on it!
This leads you to the build detail view where you could do troubleshooting with the build logs. For now, click Deploy to get the built app version running.
Select the stage and affirm the deploy by clicking Continue
Congratulations, the Hello World application is running now.
See the results
To take a look at it, navigate back to your project view and go to the stage detail view
There, you see the single component we declared in pergola.yaml named hello-world-runner. You can click on the logs-icon on the right to see your Hello-World-Output.
There it is.
- You successfully created and deployed your application on Pergola.
For a more detailed tutorial, please refer to: Hello World Tutorial