Comment on page
Use Docker Compose
- 4 CPU
- 8 GB memory
- 25 GB storage
- 1.Ubuntu or Debian installation on the box.
- You need to be able to SSH or have a console access to it.
- You need a root access on it.
- 2.The secrets file provided by Aviator.
- 3.A domain name that can be assigned to the Linux box.
$GITHUB_URL
: Hostname where GitHub is hosted$AV_HOSTNAME
: Hostname where Aviator is hosted (e.g. aviator.example.com
)$GITHUB_APP_ID
: ID generated when a GitHub app is created$MERGEQUEUE_PEM_FILE
: Private key generated by GitHub for AviatorConfigure the DNS records so that
$AV_HOSTNAME
points to your Linux box. Depending on your DNS, this may take some time to propagate. Make sure the hostname resolves before moving on.Verify that Docker engine is installed and running, otherwise follow the instructions here to install.
Create
/opt/mergequeue/keys
directory and copy $MERGEQUEUE_PEM_FILE
there. The file name must be mergequeue.pem
.$ sudo mkdir -p /opt/mergequeue/keys
$ sudo mv mergequeue.pem /opt/mergequeue/keys/
$ sudo chmod 0644 /opt/mergequeue/keys/mergequeue.pem
Extract the
aviator.zip
file provided by us, and open enterprise/install.sh
in your favorite editor. There are configs around the top of the script. You will need to modify the variables there. Here are some details for each secret value:Value | Description |
---|---|
AWS_ACCESS_KEY_ID , AWS_SECRET_ACCESS_KEY | Provided in the secrets file, used to pull Docker images. |
LICENSE_KEY | Provided in the secrets file. |
CERT_EMAIL | Email used by LetsEncrypt. This is where you will get emails about expiring certificates. During our setup of LetsEncrypt certificate, we also enable auto-renewal cron. |
GITHUB_URL | Same as $GITHUB_URL . This is only the hostname without any “https://” and any trailing slashes. |
HOSTNAME | Same as $AV_HOSTNAME . This is only the hostname of Aviator server without any “https://” and any trailing slashes. |
GITHUB_APP_ID | The same $GITHUB_APP_ID mentioned in Step 3. |
SUMO_ACCESS_ID , SUMO_ACCESS_KEY | We use sumo logic for log tracking. These values should be provided to you in the keys. |
Save the file.
Once the configurations above are set, run the install script. This will pull, build and start all the docker containers required for the Aviator service.
$ ./install.sh
At the end of that script, it will run docker-compose up -d to start the containers as detached. You can verify that the containers are running by:
$ sudo docker-compose ps
At this point, you should be able to open
$AV_HOSTNAME
in the browser.Once the page loads, you can go and register a new account from the following url on the app and follow the instructions.
https://$AV_HOSTNAME/register
It will guide you to connect the GitHub Repository with the GitHub app you created. Once authorized, you should see the connected repositories on your Repository page.
Use the same account for all purposes. You can invite other team members to this account from the Account / Users and Roles section.
Note that registering multiple accounts is disabled for on-prem, if you need additional accounts please contact [email protected].
If the setup above fails, or docker fails to start containers, please reach out to the Aviator team. And share the output of install script along with logs from docker-compose:
$ sudo docker-compose logs
Last modified 24d ago