Guides / Get started
Create a billing account and a project
Before you can build anything you need a project, and every project needs a billing account. You create both once, then work inside the project.
A billing account says who pays. A project is an isolated logical cluster with its own hostname, and everything you build later lives in one.
Create both
Billing accounts and projects live in the platform cluster, https://api.etorm.com, so send this to the platform endpoint rather than to a project.
kubectl --server https://api.etorm.com --token "$ETORM_TOKEN" apply -f - <<'YAML'
apiVersion: billing.etorm.com/v1alpha1
kind: BillingAccount
metadata: {name: acme}
spec: {displayName: Acme Inc, contactEmail: billing@acme.example}
---
apiVersion: resourcemanager.etorm.com/v1alpha1
kind: Project
metadata: {name: acme-prod}
spec: {displayName: Production, billingAccountRef: {name: acme}}
YAML
Anyone who is signed in can create a billing account, and creating one makes you its owner.
Wait for the project, then use its endpoint
Project acme-prod answers at https://acme-prod-api.etorm.com, with no /clusters/… in the path. Wait until its status says it is ready before you send anything there.
kubectl --server https://api.etorm.com --token "$ETORM_TOKEN" get project acme-prod -o jsonpath='{.status.phase}' # Active
Names and limits
- Project names are DNS labels (lowercase letters, digits, dashes, at most 63).
root,system,defaultand names starting withetorm-orkube-are reserved. - A project has exactly one billing account, and an account can have many projects.
- If you are not a platform operator, you can have up to 20 projects per account and up to 5 accounts.
- A billing account cannot be deleted while a project uses it.
Clean up
kubectl --server https://api.etorm.com --token "$ETORM_TOKEN" delete project acme-prod kubectl --server https://api.etorm.com --token "$ETORM_TOKEN" delete billingaccount acme
Deleting a project removes everything in it. Delete the project before the billing account, because the account cannot go while a project still uses it.