Pooling

Maintain a pool of pre-started sandbox environment to reduce setup time when a learner starts a track.

What is pooling?

By default, sandbox environments start on-demand when a learner starts a track. This can be undesirable if a sandbox takes a long time to become ready. With pooling you can ensure that there is a pool of environments available that are instantly available when a learner starts a new track.

How does it work?

Creating a pool of available environments

  1. Navigate to the pooling settings on your organization's home page.

  2. Set the pool size for your track to the desired amount. Building up the pool may take some time depending on the amount you specify. Once the desired amount of pooled sandbox environments are created, the platform will maintain the desired amount of pooled sandbox environments. This means that the platform will create new pooled environments once a learner claims one of the available sandboxes.

Changing pool sizes or draining instances will never stop a running track

Please keep in mind that environments in a pool will continue to run until they are used, or drained. Sandbox environments will be billed as if they are in use by a user.

Draining a pool

  1. Navigate to the pooling settings on your organization home page.

  2. Set the pool size for the track to zero. The sandbox environments in the pool will continue to run until you drain the pool.

  3. To empty the pool and stop idling sandbox environments, press the drain button. This will stop all environments in excess of the configured pool size.

Use cases

Create and maintain a pool of environments

When?

When you have a constant use of a track, you can use pooling to maintain a few standby instances to reduce start time for your users. Examples are:

  • You have organic traffic to one of your tracks.

  • You distribute track invites via a social media or marketing campaign.

  • You have embedded an Instruqt track on a documentation page.

How?

  1. Adjust the pool size of the desired track.

  2. Wait for the "Actual pool size" to have the same number as the configured pool size.

  3. After this, the platform will try to maintain the pool size. This means that if you configure a track pool size of five, and two environments are claimed when a learner starts a track, the Instruqt platform will automatically create 2 new pooled environments to match the desired 5 environments.

Create a one-time pool of environments

When?

When you are organizing a workshop or training, and want to give a group of people access to one or more tracks.

How?

  1. Adjust the pool size of the desired track.

  2. Wait for the "Actual pool size" to have the same number as the configured pool size.

  3. Adjust the configured pool size back to 0. Note, this will not destroy any pooled instances that were already created, but will prevent the platform from creating new instances when one gets claimed by a user.

  4. After the workshop, drain any leftover pooled instances.