We recommend as Best Practice to store your Botium test cases in a Git repository, and connect your Git repository to Botium Box.
Git Repository Registration
In the Botium Box registration page, it is possible to
set the Git Clone Url
the Git User
and the Git Password
You can do additional configuration with environment variables. All of those environment variables have to be to given to the Botium Box Server and all Botium Box Agents.
Detailed Git Configuration
For all of the following environment variables, there are two simple rules.
The environment variable can be used multiple times by adding a suffix of your choice
Botium Box will recognize all of them.
Each environment variable optionally starts with a prefix, which is matched with the current Git Clone Url. For example, this environment variable is only applied if the Git Repository is on Bitbucket:
Using these two rules together, you can apply different configuration for each of your Git Repositories.
Environment Variable: BOTIUMBOX_GIT_USER and BOTIUMBOX_GIT_PASSWORD
Used for HTTP/HTTPS Clone Urls only
Git SSH Keys
Environment Variable: BOTIUMBOX_GIT_PUBLICKEY and BOTIUMBOX_GIT_PRIVATEKEY and BOTIUMBOX_GIT_PASSPHRASE
Used for SSH Key authentication, for respective Clone Urls only. The public key and private key setting have to point to the SSH key files (usually id_rsa.pub and id_rsa). If protected by a passphrase, add it as well.
Place those SSH key files in the resources folder of your Botium Box installation and use relative filenames (./resources/my-key-dir/id_rsa)
Environment Variable: BOTIUMBOX_GIT_PROXY_URL and BOTIUMBOX_GIT_PROXY_USER and BOTIUMBOX_GIT_PROXY_PASSWORD
In case you are using a corporate proxy to connect to the Git Repository, add the Proxy Url and if required username/password for proxy access.
Example: Bitbucket with HTTPS
In Botium Box Git Repository registration, adding this as Git Clone Url: