Anka Build Getting Started with Jenkins

We’re excited to announce our Anka Build Getting Started with Jenkins script which is now available in the Anka Build Getting Started repository. If you’re already familiar with our Announcing the Anka Build Getting Started Repository blog post, you’ll know that we aim to provide scripts to help set up and run Anka Build software. This repository has scripts which are excellent for installing the Anka Build Virtualization CLI, the Anka Build Cloud Controller & Registry, and generating VM Templates and Tags.

As promised in our first blog, we want to provide scripts for running not only the Anka Build software, but even CI/CD platforms, all within the same machine.

Within the getting started repository, we have included what you need to:

  • Run a Jenkins LTS container with example jobs and all of the configurations you need to start running jobs right away using: ./JENKINS/install-jenkins-on-docker.bash
  • Generate your first VM Template and the necessary Jenkins Tag using: ./ANKA_BUILD_CLOUD/create-template.bash && /ANKA_BUILD_CLOUD/create-tags.bash 10.15.5 –jenkins

Once set up, you’ll be able to navigate to the Jenkins URL we create for you (http://anka.jenkins:8092). You’ll find example jobs using both Freestyle/Static Slave Templates and Dynamic Labelling jobs that pull a Jenkinsfile from a GitHub repo. If you’ve already used the Anka scripts to create the necessary VM Templates, the example jobs will start a VM locally and execute the job commands inside.

getting-started-repo-jenkins

If you’re curious, go over and check out the Anka Build Getting Started with Jenkins script at https://github.com/veertuinc/getting-started.

Our existing getting started documentation can be found at https://ankadocs.veertu.com/docs/getting-started.

Using the Anka VM GitHub Action with Anka Build

GitHub Actions has quickly become a favorite for most organizations and projects as they are already using GitHub repositories for code version control. It’s also easy to use and simple to get up and running. Here at Veertu, we’re committed to providing integrations and plugin for the various CI/CD platforms and tools that exist. This is why we’re excited to announce our own beta Anka VM GitHub Action! You can find it on the official GitHub Action Marketplace.

Within the Anka VM GitHub Action, we’ve included what we believe are the features needed for the majority of use-cases in modern CI/CD systems:

  • Ability to set both the Anka Template name or UUID and Anka Template Tag you wish to use, per step.
  • Pass options to anka run (inherit environment variables from the host into VM, wait for networking, time to sync, use a different working directory inside of the VM, and disable host <-> guest mounting) and anka start (attach your USB devices to the VM) commands.
  • Artifact uploading
  • STDOUT and STDERR are combined into an output that you can parse for subsequent steps/tests.
  • Proper job cancellation and failure handling/cleanup with Post steps.

It’s important to note that our Anka VM GitHub Action cannot be used with the GitHub hosted macOS hardware. GitHub hosted macOS hardware does not include or license the Anka Virtualization product. Fortunately, GitHub provides self-hosted runner software you can install onto your local or CI/CD macOS machine that will process jobs for your project’s repo or for the entire organization in GitHub. You then install the Anka Build Cloud and license it on that same machine. Visit https://veertu.com/anka-build-trial/ to obtain your free trial of Anka Build Cloud.

Check out our documentation on using the Anka VM GitHub Action or the GitHub Marketplace readme. We also have a video walkthrough available:

We expect customer and internal testing over the coming months to expose weaknesses and missing features. While it is in beta, please contact support@veertu.com or open a GitHub issue with any comments or concerns.