LogoLogo
WebsiteTechnical Discussions
Developer documentation
Developer documentation
  • Public Technical Documentation
    • device-management-service
      • main
        • actor
        • api
        • cmd
          • actor
          • cap
        • db
          • repositories
            • clover
        • dms
          • behaviors
          • jobs
          • node
          • onboarding
          • resources
        • docs
          • deployments
          • onboarding
          • private_network
        • executor
          • docker
          • firecracker
          • background_tasks
          • config
          • hardware
        • maint-scripts
        • network
          • libp2p
        • observability
        • specs
          • basic_controller
          • s3
          • volume
          • integration
        • tokenomics
        • types
        • utils
          • validate
      • release
        • actor
        • api
        • cmd
          • actor
          • cap
        • db
          • repositories
            • clover
        • dms
          • behaviors
          • hardware
          • jobs
          • node
          • onboarding
          • resources
        • docs
          • deployments
          • onboarding
          • private_network
        • executor
          • docker
          • firecracker
        • internal
          • background_tasks
          • config
        • maint-scripts
        • network
          • libp2p
        • observability
        • plugins
        • specs
        • storage
          • basic_controller
          • s3
          • volume
        • test
        • tokenomics
        • types
        • utils
          • validate
    • solutions
      • asi-node
        • main
          • demos
            • ocap_auth
              • ansible
              • videos
          • did-auth-use-scenarios
            • create-a-hosting-deployment
            • make-a-payment
            • manage-dids-and-ocaps
            • register-an-ai-agent
            • submit-a-compute-job
          • pilots
            • asi-create-authentication-poc
        • release
      • nunet-appliance
        • main
        • release
    • test-suite
      • main
        • cicd
          • tests
            • feature_environment
          • cli
          • dms-on-lxd
            • local
        • environments
          • development
          • feature
          • production
          • staging
        • infrastructure
          • cloud-init
          • dms-on-lxd
          • nginx
        • lib
        • stages
          • dependency_scanning
          • functional_tests
          • integration_tests
          • load_tests
          • regression_tests
          • security_tests_1
          • security_tests_2
          • security_tests_live
          • unit_tests
          • user_acceptance_tests
      • release
        • cicd
          • tests
            • feature_environment
          • cli
          • dms-on-lxd
            • local
        • environments
          • development
          • feature
          • production
          • staging
        • infrastructure
          • cloud-init
          • dms-on-lxd
          • nginx
        • lib
        • stages
          • dependency_scanning
          • functional_tests
          • integration_tests
          • load_tests
          • regression_tests
          • security_tests_1
          • security_tests_2
          • security_tests_live
          • unit_tests
          • user_acceptance_tests
    • team-processes-and-guidelines
      • main
        • best_practices
        • ci_cd_pipeline
        • community_feedback_process
        • contributing_guidelines
        • git_workflows
        • nunet_test_process_and_environments
        • secure_coding_guidelines
        • specification_and_documentation
        • team_process
          • a_project_management
          • b_ceremonies_artifacts
          • c_drum_buffer_rope
          • d_development_process
          • e_culture_rules
          • f_mr_review
        • vulnerability_management
          • devsecops_maturity_models
          • nunet_security_pipeline
          • secret_management
          • sop_security_mr_review
Powered by GitBook
On this page
  • DMS on LXD Environment Usage Guide
  • Using Environment-Specific Configurations
Export as PDF
  1. Public Technical Documentation
  2. test-suite
  3. main
  4. cicd

dms-on-lxd

PreviouscliNextlocal

Last updated 11 hours ago

Last updated: 2025-05-15 01:09:38.753073 File source:

DMS on LXD Environment Usage Guide

Using Environment-Specific Configurations

The scripts in this directory support running multiple isolated DMS-on-LXD environments by using the DMS_ON_LXD_ENV environment variable. This variable controls:

  • The config file name (config-{ENV}.yml)

  • The Terraform workspace name

  • The instance name prefix

  • The environment-specific LXD token file

Required Environment Variables

When using DMS_ON_LXD_ENV, you must set:

  • DMS_ON_LXD_ENV: Your environment name (e.g., "staging", "testing")

  • DMS_SOURCE: Path to the DMS debian package file

Optional Environment Variables

You can customize the environment further with:

  • INSTANCE_TYPE: Defaults to "virtual-machine"

  • DISTRO_VERSION: Defaults to "24.04"

  • DISTRO_NAME: Defaults to "ubuntu"

  • LXD_LOCAL_PORT: LXD API port (defaults to 8443)

  • LXD_LIMIT_MEM: Sets LXD VM memory limit (defaults to 4GB)

  • LXD_LIMIT_CPU: Sets LXD VM VCPU limit (defaults to 2)

  • DMS_ON_LXD_DOCKER: Controls whether to run commands in Docker (defaults to "true")

  • DMS_ON_LXD_VERBOSE: Verbose mode prints more info to the terminal (defaults to "false")

  • DMS_ON_LXD_APPLY_DOCKER_PATCH: Apply iptables fix for docker and lxd compatibility (defaults to "true")

  • MAX_ITER: Maximum number of iterations to wait for DMS (defaults to 30)

  • POLLING_INTERVAL_SECONDS: Time to wait between DMS checks (defaults to 10)

  • TF_APPLY_STRICT: If set, destroys infrastructure on apply failure

  • DMS_ON_LXD_DOCKER_PATCH: Apply iptables fix for docker and lxd compatibility (defaults to "true"). Possible values: "true", "false".

  • DMS_ON_LXD_OVERWRITE_DEB: Overwrite the existing DMS debian file if it exists (defaults to "false"). Possible values: "true", "false".

  • DMS_ON_LXD_INSTANCES_COUNT: Number of DMS instances to create (defaults to 2). Possible values: any positive integer.

Usage

Direct usage of the project is discouraged. The recommended way of interacting with it is via the CLI. Refer to the for more information.

link on GitLab
CLI Guide