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

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.

Next

Build an IPv6-only network.