Projects and services
A project groups the services of one app, such as its web server, its workers and its database. A service is one thing that runs in it.
Create a project
Open Projects
Click Projects in the sidebar, then New project.
Name it
Enter a name of up to 64 characters and click Create project. Project names are unique within your Harblet.
Harblet opens the new project. Its Services tab lists the services in it, and the Settings tab lets you delete it.
Add a service
On the project's page, click New service and choose what to deploy:
Every new service deploys right away. Its card on the project page shows the status of its latest deployment.
Connect services to each other
Services in the same project reach each other over a private network. Each service with a port has an internal address, shown on its Overview tab under Connection:
web-k3x9:3000
The first part is the service's internal hostname. Harblet makes it from the service's name when you create the service, plus four random characters. The second part is the service's port. Use the address in the other services' environment variables, for example:
API_URL=http://api-m2p7:8080
- Other projects can't reach the address. Each project is isolated from the others.
- The internet can't reach it either. Visitors only reach a service through its domains.
- The hostname never changes. Renaming the service later keeps its internal address.
- A service without a port has no address. Set one under Settings if other services need to connect to it.
The service page
Open a service from its project to see its tabs:
| Tab | What it's for |
|---|---|
| Overview | The internal address, or a database's connection details |
| Deployments | Every deployment with its build output and events. See Deployments and logs. |
| Logs | The live output of the running service |
| Environment variables | See Environment variables. Not for databases. |
| Domains | See Domains and HTTPS. Not for databases. |
| Backups | See Database backups. Databases only. |
| Settings | Name, source, port, health check, deploy hook, and deleting the service |
The Deploy button at the top right of every tab starts a new deployment.
Delete a service
Open the service's Settings tab and click Delete service. Harblet deletes the service, its domains, environment variables and deployments.
You can't delete a service while one of its deployments is building or deploying. Wait for it to finish, or cancel the build.
Delete a project
Open the project's Settings tab and click Delete project. Harblet deletes the project and all of its services, including their data. This can't be undone.