Setting up host integration

Host integration allows Tonic Structural to reach outside of the the Structural software so that it can interact with the system that runs Structural.

You need to configure host integration so that you can:

• Monitor Structural services

• For Kubernetes, use the one-click option to update Structural. You must configure the host integration properties, and at least one user on your instance must have the Update Tonic global permission.

Kubernetes

In your values.yaml file, under tonicai.web_server.features, set the following properties:

host_integration_enabled: "true"  
kubernetes_role: "default" 

Docker

In your environment file, uncomment and set the following properties:

TONIC_HOST_INTEGRATION=DockerCompose
TONIC_HOST_INTEGRATION_ACL=https://tonic_docker_acl

For information about setting these values, go to the readme.

In docker-compose.yaml, make sure that services.tonic_web_server.environment refers to the values set in the environment file.

TONIC_HOST_INTEGRATION: ${TONIC_HOST_INTEGRATION:-"None"}
TONIC_HOST_INTEGRATION_ACL: ${TONIC_HOST_INTEGRATION_ACL}

Also in docker-compose.yaml, uncomment the following section:

    # tonic_docker_acl:
    #     image: quay.io/tonicai/tonic_docker_acl:${VERSION_TAG:-latest}
    #     container_name: tonic_docker_acl
    #     mem_limit: 512m
    #     environment:
    #         ENVIRONMENT_NAME: ${ENVIRONMENT_NAME}
    #     volumes:
    #         - /var/run/docker.sock:/var/run/docker.sock
    #     networks:
    #       - tonic-ai