We recommend as Best Practice to store your Botium test cases in a Git repository, and connect your Git repository to Botium.
Git Repository Registration
In the Botium 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 Server and all Botium Agents.
Detailed Git Configuration
-
The environment variable can be used multiple times by adding a suffix of your choice:
-
BOTIUMBOX_GIT_IGNORECERTIFICATE**_0**=…
-
BOTIUMBOX_GIT_IGNORECERTIFICATE**_1**=…
-
…
-
-
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:
-
BOTIUMBOX_GIT_IGNORECERTIFICATE=bitbucket 1
-
Ignoring SSL Certificate Problems
Environment Variable: BOTIUMBOX_GIT_IGNORECERTIFICATE
1 to ignore SSL errors.
Git User and Password
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
id_rsa.pub
and
id_rsa
). If protected by a pass-phrase, add it as
well.(./resources/my-key-dir/id_rsa)
Proxy Settings
BOTIUMBOX_GIT_PROXY_URL
and
BOTIUMBOX_GIT_PROXY_USER
and
BOTIUMBOX_GIT_PROXY_PASSWORD
Example: Bitbucket with HTTPS
In Botium Git Repository registration, adding this as Git Clone Url:
https://botium@bitbucket.org/botium/testbox.git
BOTIUMBOX_GIT_USER_0=testbox.git mybitbucketuser
BOTIUMBOX_GIT_PASSWORD_0=testbox.git mybitbucketpassword
Example: Bitbucket with SSH
In Botium Git Repository registration, adding this as Git Clone Url:
botium@bitbucket.org:botium/testbox.git
id_rsa
and id_rsa.pub
files in the
resources folder of the Botium. Now we have to use some environment
variables:BOTIUMBOX_GIT_PUBLICKEY_0=testbox.git resources/id_rsa.pub
BOTIUMBOX_GIT_PRIVATEKEY_0=testbox.git resources/id_rsa