Skip to content

Request resources

Ask for cloud resources in the PULSE app. Sign in once with your @openmined.org email. The app shows your requests and your boxes.

Sign in to PULSE Request a resource

In Slack, type /pulse request. It opens the same request as a form.

What you can request

Resource What you get Status
Box A governed virtual machine (VM) for one purpose, with an end date. It can deploy your app from an OpenMined repository. Read the box guide. Available now
Repository with guardrails A new OpenMined repository with branch protection and required checks. Coming soon
Cluster tenant A space for your app on the shared Kubernetes cluster. Coming soon
Web URL A team web address behind OpenMined sign-in. Today you can get one only for a box. Coming soon

The rules

  • A box has one purpose and an end date.
  • The end date is at most 60 days away. You can renew it.
  • Say what you need in numbers (vCPU, RAM and disk), and PULSE picks the cheapest size that has them. Or pick a size from the list. The form shows the cost before you send.
  • The data disk is 64, 128, 256 or 512 GiB. It can grow later. It cannot shrink.
  • PULSE runs at most 5 boxes at a time, for at most $600 a month in total.
  • SSH is open from any address by default. Only SSH keys can log in. Passwords never work.
  • To allow SSH only from some addresses, list 1 to 5 public IPv4 addresses, one address each (/32).
  • A box deploys only from repositories in the OpenMined GitHub organization.
  • Never put a secret in a request. Put secrets on the box over SSH, after the box exists.
  • A box costs money also when it is stopped. The platform owner approves the cost when they approve the request.

How a request works

  1. Ask. Sign in to PULSE and fill in the form, or use /pulse request in Slack. For the size, give the numbers (for example 4 vCPU, 16 GB RAM, 80 GB disk), or pick a size. 80 GB of disk becomes a 128 GiB disk: the cloud bills disks in steps, so it costs the same.
  2. Wait for approval. PULSE opens a pull request with your ticket and asks the platform owner to review it. The platform owner reviews it and merges it. The merge is the approval. It also approves the cost.
  3. Build. CI builds the box after the merge. The box runs about 10 minutes later.
  4. Come back. Open My PULSE. It shows each request and box with its state. When the box is ready, the box page shows the ssh command and the host key to check. Log in with ssh box@<name>.box.dev.openmined.org. <name> is the box name. Then read the box guide.

If the PULSE app does not work

  1. Use /pulse request in Slack. It is a second door to the same request.
  2. If Slack does not work either, write the ticket by hand. Copy the ticket example from the box guide and fill it in. The field rules say what each field takes.
  3. Post the ticket in #pulse-requests. Engineers with write access to the infrastructure repository can open the pull request themselves. Do not merge it yourself. The platform owner merges it.

After you send it

  • Watch My PULSE, or your direct messages in Slack. The platform owner can ask questions on the pull request.
  • CI checks the ticket again. CI is the final check, not the form.
  • After the merge, the box runs in about 10 minutes.
  • Later, you can change only some fields of the ticket: expiry, ssh_from, open_ports, shutdown, size, disk_gib (bigger only), and operators (for start and stop only). A change to deploy, expose, ssh_key, or purpose has no effect on the box. Fill them in now, in this request. Read what a change does, renew, and retire.