Skip to content
bundling a WSL distro with CNAB? yes we can!
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cnab/app
README.md
cnab-setenv.sh
porter.yaml

README.md

CNAB bundle for WSL distro

Prerequesites

  1. Have Windows 10 Insiders 18305 minimum
    • It will work in the Windows 10 1903 release (no Insider need)
  2. Have a WSL store distro installed
  3. Have Porter installed
  4. Have the docker cli installed on WSL
    • You can also work with docker.exe directly by setting the variable DOCKER_SOURCE=docker.exe
  5. The path of both DISTRO_SOURCE and DISTRO_PATH must be on the Windows filesystem (/mnt/c/...)
    • In my config, I created a symlink /github to /mnt/c/github

Install a new distro

The only limitation here is: the distro needs to be in a container registry (read for 99%: https://hub.docker.com)

Test online

  • If you only want to try it out with Alpine you can also run:
curl https://raw.githubusercontent.com/nunix/wslcnab/master/cnab-setenv.sh | bash -s install

Run offline

  1. Clone the repository:
git clone https://github.com/nunix/wslcnab.git
  1. Modify the values in cnab-setenv.sh script:
    • DISTRO_IMAGE: name of the container image and the version can be added: export DOCKER_IMAGE=ubuntu:19.04
    • DISTRO_NAME: name of your distro, MUST BE UNIQUE, which will be listed/called by wsl.exe
  2. Install a new distro
./cnab-setenv.sh install
  1. Uninstall your distro
./cnab-setenv.sh uninstall

Enjoy!

You can’t perform that action at this time.