README.md

VIC Engine Integration & Functional Test Suite

To run the integration tests locally:

Automatic with defaults

Use ./local-integration-test.sh

Manually configure local Drone

• Create a test_secrets.yml file that includes:

  environment:
    GITHUB_AUTOMATION_API_KEY: <token from https://github.com/settings/tokens>
    TEST_BUILD_IMAGE:
    TEST_URL_ARRAY: <IP address of your test server>
    TEST_USERNAME: <username you use to login to test server>
    TEST_PASSWORD: <password you use to login to test server>
    TEST_RESOURCE: <resource pool, e.g. /ha-datacenter/host/localhost.localdomain/Resources>
    TEST_DATASTORE: <datastore name, e.g. datastore1>
    TEST_TIMEOUT: 60s
    VIC_ESX_TEST_DATASTORE: <datastore path, e.g. /ha-datacenter/datastore/datastore1>
    VIC_ESX_TEST_URL: <user:password@IP address of your test server>
    DOMAIN: <domain for TLS cert generation, may be blank>
  

  If you are using a vSAN environment or non-default ESX install, then you can also specify the two networks to use with the following command (make sure to add them to the yaml file in Step 2 below as well):

    BRIDGE_NETWORK: bridge
    PUBLIC_NETWORK: public
  

• Execute Drone from the project root directory:

  Drone will run based on .drone.local.yml - defaults should be fine, edit as needed

  • To run only the regression tests:

    drone exec --trusted -E "test_secrets.yml" --yaml ".drone.local.yml" --payload '{"build": {"branch":"regression", "event":"push"}, "repo": {"full_name":"regression"}}'
    

  • To run the full suite:

    drone exec --trusted -E "test_secrets.yml" --yaml ".drone.local.yml" --payload '{"build": {"branch":"master", "event":"push"}, "repo": {"full_name":"vmware/vic"}}'
    

Test a specific .robot file

• Set environment in robot.sh

• Run robot.sh with the desired .robot file

  From the project root directory:

  ./tests/robot.sh tests/test-cases/Group6-VIC-Machine/6-04-Create-Basic.robot
  

Find the documentation for each of the tests here:

• Automated Test Suite Documentation
• Manual Test Suite Documentation