The simplest way to run BuildVu on Google Cloud Platform is to run a single container on a standalone instance. We can do this by specifying a container image when we create the instance:
Start by creating a project in GCP:
When your project is ready, you should see the following screen:
Click on 'Compute Engine' in the sidebar, and it will take you to the following screen:
Once the spinner disappears, the 'Create' button should become active. Click it. You will see the 'Create Instance' screen:
Give your instance a name and pick a region near you. The default Zone and machine configuration should be fine.
Now tick 'Deploy a container image to this VM instance', and a new field should appear where you can enter your image name. Enter 'idrsolutions/buildvu'
Now click 'Advanced container options'. In order to download BuildVu, you need to supply your BuildVu license details as environment variables.
You can get a trial token from https://www.idrsolutions.com/buildvu/trial-download/ if you need one.
Once you've got your credentials, click 'Add Variable' under 'Environment Variables'. For trial users, you need the following variables:
For the full version, you need to supply your 'LICENSE_USERNAME' and 'LICENSE_PASSWORD' as well as the name of the 'PRODUCT' you have a license for (buildvu, buildvu-html or buildvu-svg).
Once your container is running, you will be able to download the results of your conversions via the API for a preset time. In addition, it is also possible to save the resulting files indefinitely to a persistent volume, so you can access them directly. For this to work, you will need to mount a volume to the container by clicking 'Add volume' under volume mounts. Fill in the form as follows, then click 'Done'.
If you intend to use HTTPS encryption (recommended), you should also define an additional volume where you can upload your SSL certificate and private key.
Scroll down to the 'Firewall' section and click 'Allow HTTP traffic', then click 'Create'
Your instance will be built and appear on the following screen when ready:
Once your instance is created, give it a few minutes to pull the image and start up the container, then click the icon next to its 'External IP'. You will be prompted for the web service username and password you supplied. If correct, you should be greeted by the BuildVu welcome screen:
You can now make API calls to http://<your_external_ip>/buildvu.
To finish enabling HTTPS, you will need to upload the certificate.crt, private.key and ca_bundle.crt files to /home/ssl once the instance is running, then restart it. Click the SSH button to open a web console:
Navigate to the /home/ssl directory, then create a new file called certificate.crt and paste the contents of your certificate file into it:
Save the file (ESC followed by :wq ENTER). Now do the same for you private key, making sure to call the file private.key, and for the certificate chain, calling it ca_bundle.crt.
BuildVu will detect the presence of the certificate and launch in HTTPS mode. All HTTP traffic will be automatically upgraded to use HTTPS encryption.
Once you've finished using the instance and no longer need it, remember to delete it so it doesn't run up your GCP bill:
Warning: if you used the instructions above to mount a directory as a shared volume, deleting the instance will also delete the mounted folder. Make sure you've downloaded any documents you wish to keep.