dpogue / solaris-vm

Use Solaris in github actions

Run GitHub CI in Solaris

Use this action to run your CI in Solaris.

The github workflow only supports Ubuntu, Windows and MacOS. But what if you need a Solaris?

This action is to support Solaris.

Sample workflow solaris.yml:

name: Test

on: [push]

jobs:
  testsolaris:
    runs-on: macos-10.15
    name: A job to run test Solaris
    env:
      MYTOKEN : ${{ secrets.MYTOKEN }}
      MYTOKEN2: "value2"
    steps:
    - uses: actions/checkout@v2
    - name: Test in solaris
      id: test
      uses: vmactions/[email protected]
      with:
        envs: 'MYTOKEN MYTOKEN2'
        prepare: pkgutil -y -i socat
        nat: |
          "8080": "80"
          "8443": "443"
          udp:"8081": "80"
        run: |
          if [ -n "test" ]; then
            echo "false"
          fi
          if [ "test" ]; then
            echo "test"
          fi
          pwd
          ls -lah
          whoami
          env
          psrinfo -vp
          cat /etc/release
          echo "OK"

The runs-on: macos-latest must be macos-latest.

The envs: 'MYTOKEN MYTOKEN2' is the env names that you want to pass into solaris vm.

The run: xxxxx is the command you want to run in solaris vm.

The env variables are all copied into the VM, and the source code and directory are all synchronized into the VM.

The working dir for run in the VM is the same as in the Host machine.

All the source code tree in the Host machine are mounted into the VM.

All the GITHUB_* as well as CI=true env variables are passed into the VM.

So, you will have the same directory and same defualt env variables when you run the CI script.

You can add NAT port between the host and the VM.

...
    steps:
    - uses: actions/checkout@v2
    - name: Test in solaris
      id: test
      uses: vmactions/[email protected]
      with:
        envs: 'MYTOKEN MYTOKEN2'
        nat: |
          "8080": "80"
          "8443": "443"
          udp:"8081": "80"
...

The default memory of the VM is 4096MB, you can use mem option to set the memory size:

...
    steps:
    - uses: actions/checkout@v2
    - name: Test in solaris
      id: test
      uses: vmactions/[email protected]
      with:
        envs: 'MYTOKEN MYTOKEN2'
        mem: 5000
...

Under the hood

GitHub only supports Ubuntu, Windows and MacOS out of the box.

However, the MacOS support virtualization. It has VirtualBox installed.

So, we run the Solaris VM in VirbualBox on MacOS.