Docs menu
Applications
An application is the top-level project on Primcloud: one git repo, one region, and one or more environments.
On this page
An application is the top-level project on Primcloud. It ties one git repo to one region and holds its environments: one, production, on Standard, and more on Pro and Team. The repo and region apply to every environment; branches, secrets, formations, and domains are set per environment.
Creating an application#
Hit Import Git Repository on the applications list. The import has three steps:
- Select a repository you've given Primcloud access to.
- Configure the branch to track, the region to run in, and any secrets to start with.
- Verify the commit and hit Import.
Primcloud then:
- Creates the application with a slug taken from the repository name, plus a short suffix so it's unique. The slug appears in your URLs and can't be changed.
- Creates a production environment tracking the branch you picked, at
<app-slug>-production.primcloud.app. - Starts the first deployment.
The application dashboard#
Every application has four tabs:
- Overview: the current release and live URL, metrics, recent deployments, formations, and recent tasks, with a bar for running a new one. The metrics chart the
webformation's CPU and memory as a percentage of its compute size: LIVE updates minute by minute, and 1H, 6H, and 24H average that window. The range you pick is kept in the page's URL, so a shared link or a refresh reopens it. - Deployments: the deployment history, with each deployment's logs and rollback and redeploy actions.
- Logs: your app's output and its HTTP requests, live and searchable.
- Settings: the display name and slug, the repo and branch, custom domains, secrets, maintenance mode, and delete.
Renaming#
Change the application's display name any time from Settings. It's the name in your app list and the dashboard header, and changing it doesn't change any URL.
To change the slug, or to transfer an application to another account, contact support.
Deleting an application#
Delete an application from the Delete Application section at the bottom of its Settings page, confirming with your password.
Every environment stops right away, so compute billing stops the same minute and your app stops serving traffic. A deployment in progress is canceled and a running task is ended.
You have 7 days to restore the application. It's permanently removed 30 days after you delete it.
Restoring a deleted application#
A deleted application stays on your applications list, greyed out, with the days left to restore it and a Restore button. Restore brings back every environment, deployment, custom domain, and task, and sets each formation back to its previous Instances. A deployment the delete canceled stays canceled and a task it ended stays ended; deploy or run it again.
Restoring starts compute again, so it needs your account in good standing. If you have an unpaid invoice, pay it first; see Past-due & Suspension.