Create new sandbox with YAML

YAML parameters for Create new sandbox

NameTypeDescription
action RequiredStringThe ID of the action.
type RequiredStringThe type of the action. Must be set to SANDBOX_CREATE_NEW.
sandbox_name RequiredStringDefines the name of the created sandbox.
sandbox_distribution RequiredStringDefines the OS distro of the sandbox. Can be one of ubuntu/focal or debian/buster.
sandbox_playbooksSandboxPlaybook[]Defines the list of playbooks to install during the sandbox creation.
tagsString[]The list of tags applied to the sandbox.
ram_limit RequiredIntDefines the amount of RAM available to the sandbox. Can be one of 2 or 4.
cpu_limit RequiredIntDefines the number of vCPUs of the sandbox. Can be one of 1 or 2.
disk_size_limit RequiredIntDefines the sandbox disk size. Expressed in GB. Can be one of 5 or 10.
mappings RequiredMapping[]Defines the port-subdomain mappings that allow to access exposed resources on the sandbox.
application_portIntDefines the port used in the mapping.
subdomainStringDefines the subdomain used in the mapping.
basic_authBooleanIf set to true, it allows you to use basic authorization in mappings
mappings_usernameStringDefines the basic auth username required to access the exposed resources.
mappings_passwordStringDefines the basic auth password required to access the exposed resources.

Playbook parameters for Create new sandbox

NameTypeDescription
type RequiredStringThe type of the installed playbook. Can be one of DOCKER, APACHE, NGINX, WORDPRESS, NODE, RUBY, MARIA, MYSQL, POSTGRES, MONGO, or REDIS
dbStringThe initial database name. Available when type is set to MARIA, WORDPRESS, POSTGRES, or MYSQL.
userStringDefines the username used in the desired service. Available when type is set to MARIA, WORDPRESS, POSTGRES, or MYSQL.
passwordStringDefines the password used in the desired service. Available when type is set to MARIA, WORDPRESS, POSTGRES, or MYSQL
install_phpStringInstalls PHP if set to true. Available when type is set to APACHE, or NGINX.
php_versionString[]The PHP version of the installed playbook. Available when type is set to APACHE or NGINX.
php_modulesString[]The PHP modules of the installed playbook. Available when type is set to APACHE or NGINX.
modulesStringThe Apache modules of the installed playbook. Available when type is set to APACHE.
versionStringThe version of the installed playbook. Available when type is set to NODE, RUBY, MONGO, or MYSQL.

YAML example for Create new sandbox (with playbooks)

yaml
actions: - action: "Create new sandbox" type: "SANDBOX_CREATE_NEW" sandbox_name: "new sandbox with playbooks" sandbox_distribution: "ubuntu/focal" sandbox_playbooks: - type: "APACHE" install_php: true php_version: "8.0" php_modules: - "gd" - "mysql" - "opcache" - "curl" - "xml" - "mbstring" - "imagick" - "zip" modules: - "expires" - "headers" - "rewrite" - type: "DOCKER" - type: "MONGO" version: "5.0" - type: "NODE" version: "12" - type: "POSTGRES" db: "test" user: "test" password: "test" - type: "REDIS" - type: "RUBY" version: "2.7" - type: "MYSQL" version: "8.0" db: "wp" user: "wp" password: "wp" - type: "WORDPRESS" db: "wp" user: "wp" password: "wp" phrase: "wp" ram_limit: 2 cpu_limit: 1 disk_size_limit: 5 mappings: - application_port: 80 subdomain: "subdomain" basic_auth: true mappings_username: "root" mappings_password: "secure!HgGGWOOdDRGVCt9A2E8iLQ==.lMfNW8nAd+N40qq0vd6z2w=="

YAML parameters for Duplicate existing sandbox

NameTypeDescription
action RequiredStringThe ID of the action.
type RequiredStringThe type of the action. Must be set to SANDBOX_CREATE_FROM_SANDBOX.
sandbox_name RequiredStringDefines the name of the created sandbox.
sandbox_id RequiredStringDefines the ID of the existing sandbox used to create new sandbox.
tagsString[]The list of tags applied to the sandbox.
ram_limit RequiredIntDefines the amount of RAM available to the sandbox. Can be one of 2 or 4.
cpu_limit RequiredIntDefines the number of vCPUs of the sandbox. Can be one of 1 or 2.
disk_size_limit RequiredIntDefines the sandbox disk size. Expressed in GB. Can be one of 5 or 10.
mappings RequiredMapping[]Defines the port-subdomain mappings that allow to access exposed resources on the sandbox.
application_portIntDefines the port used in the mapping.
subdomainStringDefines the subdomain used in the mapping.
basic_authBooleanIf set to true, it allows you to use basic authorization in mappings
mappings_usernameStringDefines the basic auth username required to access the exposed resources.
mappings_passwordStringDefines the basic auth password required to access the exposed resources.

YAML example for Duplicate existing sandbox

yaml
actions: - action: "Create new sandbox from existing" type: "SANDBOX_CREATE_FROM_SANDBOX" sandbox_name: "sandbox-buddy" sandbox_id: "BJ7YnoUVtfGdo" tags: - "tag_1" - "tag_2" ram_limit: 2 cpu_limit: 1 disk_size_limit: 5 mappings: - application_port: 80 subdomain: "buddy-subdomain" username: "root" password: "secure!SNCLQcJdggA0xk2lxAxhiw==.ud7C2Ucd/M6SB9rtTHYvVQ=="

YAML parameters for Create from snapshot

NameTypeDescription
action RequiredStringThe ID of the action.
type RequiredStringThe type of the action. Must be set to SANDBOX_CREATE_FROM_SNAPSHOT.
sandbox_name RequiredStringDefines the name of the created sandbox.
snapshot_id RequiredStringDefines the ID of the snapshot used to create a sandbox.
tagsString[]The list of tags applied to the sandbox.
ram_limit RequiredIntDefines the amount of RAM available to the sandbox. Can be one of 2 or 4.
cpu_limit RequiredIntDefines the number of vCPUs of the sandbox. Can be one of 1 or 2.
disk_size_limit RequiredIntDefines the sandbox disk size. Expressed in GB. Can be one of 5 or 10.
mappings RequiredMapping[]Defines the port-subdomain mappings that allow to access exposed resources on the sandbox.
application_portIntDefines the port used in the mapping.
subdomainStringDefines the subdomain used in the mapping.
basic_authBooleanIf set to true, it allows you to use basic authorization in mappings
mappings_usernameStringDefines the basic auth username required to access the exposed resources.
mappings_passwordStringDefines the basic auth password required to access the exposed resources.

YAML example for Create from snapshot

yaml
actions: - action: "Create new sandbox from snapshot" type: "SANDBOX_CREATE_FROM_SNAPSHOT" sandbox_name: "sandbox-buddy" snapshot_id: "sn-SsWzv1Y1xBrYX" tags: - "tag_1" - "tag_2" ram_limit: 2 cpu_limit: 1 disk_size_limit: 5 mappings: - application_port: 80 subdomain: "buddy-subdomain" username: "root" password: "secure!SNCLQcJdggA0xk2lxAxhiw==.ud7C2Ucd/M6SB9rtTHYvVQ=="
Last update:
Sep 23, 2024