​

Template Basics

Environment templates define the configuration, resources, and settings for your simulation environments. This guide covers the fundamentals of creating and working with templates.

​

Template Structure

A wirtual.dev template consists of:

​

Creating Templates

​

Initialize Template

Start with a pre-built template or create from scratch:

wirtual templates init --id devcontainer-docker
cd my-template

​

Configure Settings

Templates support various configuration options:

# Set default parameters
wirtual templates push my-template \
    --parameter "simulation_type=training" \
    --parameter "gpu_enabled=true"

# Configure provisioner
wirtual templates push my-template \
    --provisioner-tag "gpu=true" \
    --provisioner-tag "region=us-west"

​

Test Template

Verify your template works as expected:

# Create test workspace
wirtual create test-env --template my-template

# Verify environment
wirtual show test-env

​

Template Components

​

Parameter Types

Templates support different parameter types for customization:

wirtual create env --parameter "robot_type=ur5"

wirtual create env --build-option "debug=true"

​

Version Control

Manage template versions effectively:

wirtual templates push my-template \
    --message "Added new sensor config"

wirtual templates versions list my-template

wirtual templates versions promote \
    --template my-template \
    --template-version v1.0

​

Next Steps