Continuous Integration (CI)

Table of contents

In order to help validate your extension and ensure it's functional, the Extension SDK provides tools to help you setup continuous integration for your extension.

Important

The Docker Desktop Action and the extension-test-helper library are both experimental.

Setup CI environment with GitHub Actions

You need Docker Desktop to be able to install and validate your extension. You can start Docker Desktop in GitHub Actions using the Docker Desktop Action, by adding the following to a workflow file:

steps:- id:start_desktopuses:docker/desktop-action/start@v0.1.0

Note

This action supports only Github Action macOS runners at the moment. You need to specify runs-on: macOS-latest for your end to end tests.

Once the step has executed, the next steps use Docker Desktop and the Docker CLI to install and test the extension.

Validating your extension with Puppeteer

Once Docker Desktop starts in CI, you can build, install, and validate your extension with Jest and Puppeteer.

First, build and install the extension from your test:

import{DesktopUI}from"@docker/extension-test-helper";import{execasoriginalExec}from"child_process";import*asutilfrom"util";exportconstexec=util.promisify(originalExec);// keep a handle on the app to stop it at the end of tests letdashboard: DesktopUI;beforeAll(async()=>{awaitexec(`docker build -t my/extension:latest .`,{cwd:"my-extension-src-root",});awaitexec(`docker extension install -f my/extension:latest`);});

Then open the Docker Desktop Dashboard and run some tests in your extension's UI:

describe("Test my extension",()=>{test("should be functional",async()=>{dashboard=awaitDesktopUI.start();consteFrame=awaitdashboard.navigateToExtension("my/extension");// use puppeteer APIs to manipulate the UI, click on buttons, expect visual display and validate your extension awaiteFrame.waitForSelector("#someElementId");});});

Finally, close the Docker Desktop Dashboard and uninstall your extension:

afterAll(async()=>{dashboard?.stop();awaitexec(`docker extension uninstall my/extension`);});

What's next

Page options
close