Hot start
Pre-provision sandboxes for instant access later on.
Overview
Hot starting is creating a pool of sandbox instances that are instantly available when a learner starts your track. Without Hot Start, sandbox environments start on demand when a learner starts a track. This means learners have to wait for Instruqt to provision the sandbox environment before they can access them.
Billing
You are billed for hot start sandboxes, even if learners are not using them.
Manage hot start pools
Create an always hot pool
Take the following steps to create an always hot pool:
Click Settings -> Hot Start to open the Manage hot start page.
Click Create.
Select the tracks or sandbox presets that you want to be preheated.
In the Name field, enter a name for the pool.
In the Number of hot sandboxes per track/sandbox preset field, enter your desired number.
For Hot Start type, select Always hot.
Click Create.
Create a scheduled pool
Take the following steps to create a scheduled pool:
Click Settings -> Hot start to open the Manage hot start page.
Select Create.
Select the tracks or sandbox presets that you want to be preheated.
In the Name field, enter a name for the pool.
In the Number of hot sandboxes per track/sandbox preset field, enter your desired number.
For Hot Start type, select Scheduled.
In the Start provisioning on field, select or enter the starting date when the pool should begin provisioning.
Select the Starting time when the pool should begin provisioning.
Select the Time to live.
Click Create.
Create hot starts from invites
It's possible to create a hot start pool from a track invite. To do so, take the following steps:
Click Share Content to open the Manage track invites page.
Click the ā¢ā¢ā¢ of the track invite you want to create a hot start pool for.
Click Create Hot Start pool on the pop-up. ā³ The Create Hot Start page opens, with the settings pre-filled.
Check the settings and click Create to create the pool.
Duplicate hot start pools
Duplicate a hot start pool with the following steps:
Click Settings -> Hot start to open the Hot start page.
Click the ā¢ā¢ā¢ of the pool you want to duplicate.
Click Duplicate on the pop-up. ā³ The Create Hot Start page opens, with the settings pre filled.
Check the settings and click Create to create the pool.
Delete hot start pools
Delete a hot start pool with the following steps:
Click Settings -> Hot start to open the Hot start page.
Click the ā¢ā¢ā¢ of the pool you want to delete.
Click Delete on the pop-up. ā³ The Delete Hot Start confirmation opens.
Click Confirm.
Best practices
To ensure a smooth and efficient experience with the Hot Start feature, follow these best practices for setup, timing, and cost management.
Use Track-Level Setup Scripts with Health Checks
The Hot Start feature relies on the successful completion of track-level setup scripts to determine if a sandbox environment is ready for a user.
Track-level Setup Scripts: Ensure all tracks in your hot start pool use track-level setup scripts for all setup tasks. A successful setup script execution (exiting with a zero exit code) signals that the instance is ready.
Challenge-level Setup Scripts: When you need to customize a sandbox environment for a specific user, you can leverage the setup script of the first challenge. This script will have user specific parameters injected as environment values. Keep in mind that this will add extra wait time for users, potentially rendering the Hot Start feature less useful.
Implement Health Checks: Add health checks to the end of your setup scripts to verify the environment is fully functional. For example, you can try calling HTTP endpoints or check that all necessary containers are running.
Automatic Retries: If a track setup fails (exits with a non-zero exit code), the instance will be terminated automatically, and a new one will be provisioned until the configured limit is reached. This mechanism ensures learners only access instances that provisioned correctly.
Time Your Provisioning Strategically
Properly timing the provisioning of your hot start pool is crucial for having environments ready when your event starts.
General Guideline: Start provisioning the hot start pool about 30 minutes before your event begins.
Adjust for Scale: You may need to start earlier if:
A single instance takes more than a few minutes to provision.
You are provisioning a very large pool of instances.
Test Your Timing: It's a good practice to test your provisioning time to ensure everything is ready for your actual event.
Terminate the Pool to Save Costs
Avoid unnecessary costs by terminating the hot start pool once most users have started their sessions.
When to Terminate: A hot start pool typically doesn't need to run for more than 15 to 30 minutes after the session starts.
Claimed vs. Unclaimed Instances: When a pool terminates, hot start instances claimed by users are not affected. Only unclaimed instances will be cleaned up.
FAQ
Video tutorial
You can also watch this video tutorial for an explanation of how hot start works:
Last updated
Was this helpful?