Compute limits and quotas

For features that Compute doesn’t support yet, see Limitations and roadmap.

Compute is in preview, and the v1alpha API can change.

Enable Compute

Compute is enabled for each project separately, and you don’t need to request access. The first time you run a datumctl compute command in a project, the command enables Compute for that project and then continues. Every command except access and help does this, including build. It doesn’t ask for confirmation, so it works the same way in CI and scripts. Enabling Compute also gives the project its default compute quota. To check whether Compute is enabled for the active project, run the following command:

datumctl compute access

The Access line shows one of the following states:

State	Meaning
`Not requested`	No `datumctl compute` command has run in the project yet. The next one enables Compute.
`Processing`	Datum is enabling Compute. This normally takes a few seconds.
`Active`	Compute is enabled, and you can deploy workloads.
`Unavailable`	Compute isn’t available to your project.

To enable Compute without running another command, run datumctl compute access request. For all access options, see Compute commands.

Quotas

Your project’s compute quota limits how many workloads and Instances you can run, how much vCPU and memory they use, and how many shell sessions can be open at once. Datum sets the quota. You can’t change it yourself. Each Instance uses the following quota:

1 Instance
1 vCPU
2 GiB (2,048 MiB) of memory

Quota is shared across runtime classes. A general-purpose Instance and a unikernel Instance use the same amount.

Check your quota

To see your project’s limits and usage, run the following command:

datumctl compute quota

The output is similar to the following:

Quota for project your-project-id

RESOURCE    UNIT        LIMIT   USED   AVAILABLE   USAGE
Workloads   workloads   10      3      7           [######--------------]  30%
Instances   instances   50      12     38          [#####---------------]  24%
vCPUs       vCPUs       32      8      24          [#####---------------]  25%
Memory      MiB         65536   16384  49152       [#####---------------]  25%

To show only the resources that are at their limit, add --constrained.

If your quota is used up

If your project doesn’t have enough quota for a new Instance, Datum doesn’t start it. The Instance shows Pending (quota exceeded) in datumctl compute instances and reports QuotaExceeded, and the workload reports QuotaNotGranted. To let the Instance start, do one of the following:

Lower the number of Instances with datumctl compute scale WORKLOAD_NAME --min=COUNT.
Delete workloads that you no longer need.
Ask for more quota by contacting support@datum.net.

If an Instance reports QuotaNoBudget, or another reason that starts with Quota, your project’s quota isn’t set up correctly. The workload exists, but its Instances don’t start. Contact support, and Datum fixes the problem.

Limits

The following table lists fixed limits:

Item	Limit
Instance type	`datumcloud/d1-standard-2` only: 1 vCPU and 2 GiB of memory
Instances in each location of a placement (`minReplicas`)	1 to 1,000
Network interfaces for each Instance	Exactly 1
Networks for each workload	1
Size of each referenced ConfigMap or Secret	256 KiB
Total size of referenced ConfigMaps and Secrets for a workload in one location	1 MiB
ALBs attached to each workload with `datumctl compute deploy`	1, on one port
Unikernel image size	The unpacked image must fit in the Instance’s 2 GiB of memory, along with the app.
Open shell sessions per Instance	3
Open shell sessions per project	10 by default. Datum can grant a project more.

What’s next

To deploy your first workload, see Deploy an app.
To review what Compute doesn’t support yet, see Limitations and roadmap.
To fix quota errors and other problems, see Troubleshooting.

Introduction

Explore

Enable Compute

Quotas

Check your quota

If your quota is used up

Limits

What’s next

​Enable Compute

​Quotas

​Check your quota

​If your quota is used up

​Limits

​What’s next

Enable Compute

Quotas

Check your quota

If your quota is used up

Limits

What’s next