Skip to content
CLI tool for spawning and running containers on Windows according to the OCI specification
Branch: develop
Clone or download
arjun024 and sophiewigmore Readme: MD files require extra new lines
Signed-off-by: Sophie Wigmore <swigmore@pivotal.io>
Latest commit c8c00df Mar 20, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmd
hcs Hcs-client: Retry HNS's network-Create() on known error Mar 13, 2019
integration
network Consider ip version when getting / setting mtu Oct 22, 2018
runtime Runtime: Fix OpenProcess race Feb 5, 2019
vendor hccshim: bumped hcsshim to v0.8.5 Feb 5, 2019
.gitignore
Gopkg.lock Gopkg.lock: Update hcsshim rev after cleaning up fork Feb 5, 2019
Gopkg.toml
LICENSE
NOTICE add license and notice May 23, 2017
README.md

README.md

winc

winc is a CLI tool for spawning and running containers on Windows according to the OCI specification.

Building

Requirements

  • Golang
    • Make sure you have set a GOPATH
  • Git
  • mingw-w64
    • Select x86_64 as the target architecture
    • After install, ensure that gcc.exe is in your PATH

To clone and build winc.exe:

go get -d code.cloudfoundry.org/winc/...
cd $GOPATH/src/code.cloudfoundry.org/winc
go build ./cmd/winc

Testing

Set the following environment variables first:

WINDOWS_VERSION to your version of Windows (e.g. "2019").

WINC_TEST_ROOTFS to the path to a container image (e.g. to test with the microsoft/windowsservercore Docker image - "docker:///microsoft/windowsservercore").

GROOT_BINARY to the path of the groot executable to use while running integration test.

GROOT_IMAGE_STORE to the path of the directory that groot uses for layers and the volume (e.g. "C:\ProgramData\groot").

To install Ginkgo and run the tests:

go get github.com/onsi/ginkgo/...
cd $GOPATH/src/code.cloudfoundry.org/winc
ginkgo -r -race -keepGoing

Using

Check out winc bosh release readme for creating new containers using winc.

You can’t perform that action at this time.