engines:create#
#rai engines:create [OPTIONS]
Creates a new RelationalAI (RAI) engine.
If an engine with the specified name already exists and is suspended, it is resumed instead of creating a new engine.
Requires the eng_admin application role.
Options#
| Option | Type | Description |
|---|---|---|
--name | Text | The name of the engine. Must be at least three characters, begin with a letter, and may only contain letters, numbers, and underscores. If missing, you are prompted to enter the name interactively. |
--size | Text | The size of the engine. Must be one of:
|
--auto_suspend_mins | Integer | The number of minutes of inactivity before the engine is automatically suspended. Must be a positive integer. If missing, the value of the auto_suspend_mins configuration key in your raiconfig.toml file is used. |
Example#
Use the engines:create command to create a RAI engine:
#$ rai engines:create --name my_engine --size HIGHMEM_X64_S
---------------------------------------------------
▰▰▰▰ Engine 'my_engine' created!
---------------------------------------------------
NOTE
The engines:create command blocks until the engine is ready, which may take several minutes.
Provide the --auto_suspend_mins option to set the number of minutes of inactivity before the engine is automatically suspended:
#$ rai engines:create --name my_engine --size HIGHMEM_X64_S --auto_suspend_mins 30
See Compute Resources for more information on RAI engines and engine management.