GitHub Actions

Loft provides the following GitHub Actions for use in workflows:

• Setup DevSpace: Installs the devspace CLI
• Setup Loft: Installs the loft CLI and logs in to the Loft instance
• Create Virtual Cluster: Creates a Virtual Cluster
• Delete Virtual Cluster: Deletes a Virtual Cluster

Spaces Too!

Check out the Spaces Integration section for examples of using the Space create/delete GitHub Actions plugins.

Virtual Clusters for Pull Requests

These examples show how to create and delete Virtual Clusters for pull requests.

Basic

This example shows how to create and delete a virtual cluster for testing an application named my-app on pull requests.

# .github/workflows/vclusters.yaml
name: Pull Request Checks
on:
  pull_request:
    branches:
      - 'main'
jobs:
  e2e:
    runs-on: ubuntu-latest
    steps:
      - name: Install Loft CLI
        uses: loft-sh/setup-loft@main
        with:
          url: ${{ secrets.LOFT_URL }}
          access-key: ${{ secrets.LOFT_ACCESS_KEY }}
      - name: Create Virtual Cluster for PR
        uses: loft-sh/create-vcluster@main
        with:
          name: pr-${{ github.event.pull_request.number }}-${{ github.sha }}-${{ github.run_id }}
      - name: Deploy Application
        run: kubectl apply -Rf ./kubernetes
      - name: Wait for Deployment
        run: kubectl rollout status deployments/my-app
      - name: Run Tests
        run: make e2e
      - name: Delete PR Virtual Cluster
        uses: loft-sh/delete-vcluster@main
        with:
          name: pr-${{ github.event.pull_request.number }}-${{ github.sha }}-${{ github.run_id }}

Explanation:

1. The Setup Loft action is used to install the Loft CLI and login using the provided url and access-key.
2. The Create Virtual Cluster action is used to create a unique virtual cluster using information about the pull request. This will automatically configure the kube context for the following steps.
3. The next step deploys the application using the runner provided kubectl and manifests located under ./kubernetes.
4. Before running tests, we use kubectl to wait for the my-app deployment to become ready.
5. Now we run the end-to-end tests. In this example we're using make to run tests, but the command should be customized for your testing framework.
6. Finally, the Delete Virtual Cluster GitHub Action is used to delete the virtual cluster.

Automatic Cleanup

This example shows how to create and reuse a virtual cluster for testing an application named my-app on pull requests.

# .github/workflows/vclusters.yaml
name: Pull Request Checks
on:
  pull_request:
    branches:
      - 'main'
jobs:
  e2e:
    runs-on: ubuntu-latest
    steps:
      - name: Install Loft CLI
        uses: loft-sh/setup-loft@main
        with:
          url: ${{ secrets.LOFT_URL }}
          access-key: ${{ secrets.LOFT_ACCESS_KEY }}
      - name: Create Virtual Cluster for PR
        uses: loft-sh/create-vcluster@main
        with:
          name: pr-${{ github.event.pull_request.number }}-${{ github.sha }}-${{ github.run_id }}
          use: true
      - name: Deploy Application
        run: kubectl apply -Rf ./kubernetes
      - name: Wait for Deployment
        run: kubectl rollout status deployments/my-app
      - name: Run Tests
        run: make e2e

Explanation:

1. The Setup Loft action is used to install the Loft CLI and login using the provided url and access-key.
2. The Create Virtual Cluster action is used to create a unique virtual cluster using information about the pull request. This will automatically configure the kube context for the following steps. Notice that we're using the use attribute to specify that we wish to reuse the virtual cluster if it still exists from a previous run.
3. The next step deploys the application using the runner provided kubectl and manifests located under ./kubernetes.
4. Before running tests, we use kubectl to wait for the my-app deployment to become ready.
5. Now we run the end-to-end tests. In this example we're using make to run tests, but the command should be customized for your testing framework.

Reuse

This example shows how to automatically delete a Virtual Cluster after testing an application named my-app for pull requests.

# .github/workflows/vclusters.yaml
name: Pull Request Checks
on:
  pull_request:
    branches:
      - 'main'
jobs:
  e2e:
    runs-on: ubuntu-latest
    steps:
      - name: Install Loft CLI
        uses: loft-sh/setup-loft@main
        with:
          url: ${{ secrets.LOFT_URL }}
          access-key: ${{ secrets.LOFT_ACCESS_KEY }}
      - name: Create Virtual Cluster for PR
        uses: loft-sh/create-vcluster@main
        with:
          name: pr-${{ github.event.pull_request.number }}-${{ github.sha }}-${{ github.run_id }}
          auto-cleanup: true
      - name: Deploy Application
        run: kubectl apply -Rf ./kubernetes
      - name: Wait for Deployment
        run: kubectl rollout status deployments/my-app
      - name: Run Tests
        run: make e2e

Explanation:

1. The Setup Loft action is used to install the Loft CLI and login using the provided url and access-key.
2. The Create Virtual Cluster action is used to create a unique virtual cluster using information about the pull request. This will automatically configure the kube context for the following steps. Additionally, we have enabled the auto-cleanup option, which will delete the virtual cluster after the job completes.
3. The next step deploys the application using the runner provided kubectl and manifests located under ./kubernetes.
4. Before running tests, we use kubectl to wait for the my-app deployment to become ready.
5. Finally we run the end-to-end tests. In this example we're using make to run tests, but the command should be customized for your testing framework. There's no need to delete the virtual cluster since the auto-cleanup option was used when creating the virtual cluster.

DevSpace

This example shows how use the Setup Devspace GitHub Action to install the DevSpace CLI and DevSpace commands to run tests.

# .github/workflows/vclusters.yaml
name: Pull Request Checks
on:
  pull_request:
    branches:
      - 'main'
jobs:
  e2e:
    runs-on: ubuntu-latest
    steps:
      - name: Install DevSpace CLI
        uses: loft-sh/setup-devspace@main
      - name: Install Loft CLI
        uses: loft-sh/setup-loft@main
        with:
          url: ${{ secrets.LOFT_URL }}
          access-key: ${{ secrets.LOFT_ACCESS_KEY }}
      - name: Create Virtual Cluster for PR
        uses: loft-sh/create-vcluster@main
        with:
          name: pr-${{ github.event.pull_request.number }}-${{ github.sha }}-${{ github.run_id }}
          auto-cleanup: true
      - name: Run Tests
        run: devspace run e2e

Explanation:

1. The Setup DevSpace action installs the DevSpace CLI.
2. The Setup Loft action is used to install the Loft CLI and login using the provided url and access-key.
3. The Create Virtual Cluster action is used to create a unique virtual cluster using information about the pull request. This will automatically configure the kube context for the following steps. Additionally, we have enabled the auto-cleanup option, which will delete the virtual cluster after the job completes.
4. Finally we use devspace run e2e to perform the needed steps to deploy and test my-app.