Tags

v1.0.0-alpha6

containerd 1.0.0-alpha6

The seventh alpha release brings further stability and testing to containerd.
This release mostly contains fixes and clean ups on the client side along with
a few bug fixes on the daemon side. There are no API changes or need to update
dependencies with this release. See changes for the full list of fixes.

Please download and test this version. Report issues at
https://github.com/containerd/containerd/issues.

Release Process

The release process and versioning guarantees have been laid out in
[RELEASES.md](RELEASES.md). It identifies the release process,
versioning, branching, support horizon and backporting processes for
containerd.

Contributors

A special thanks to the contributors of this release:

Akihiro Suda
Brian Goff
Christopher Jones
Derek McGowan
Kenfe-Mickaël Laventure
Kunal Kushwaha
Michael Crosby
Phil Estes
Stephen Day
Zhang Wei

Changes

f05281743e Merge pull request #1420 from dmcgowan/alpha6
b14c2cce11 release: updated version to alpha6
709c37b1d1 Merge pull request #1419 from dmcgowan/walk-skip-not-found
0daa593b3a Merge pull request #1393 from dmcgowan/multiple-differs
98960f0493 Skip items removed during walk
05cdc4f435 Merge pull request #1417 from mlaventure/delete-exitedat
7f6c487031 go-client: Return an ExitStatus struct when calling process.Delete()
12b43a5c8a Merge pull request #1416 from tophj-ibm/fix-race-testflags
e6ab556f0e Only use race flag on amd64
60fea11686 Merge pull request #1400 from dmcgowan/content-local-writer-locks
311ea33608 Merge pull request #1414 from dmcgowan/btrfs-test-fail-2
3bcb6f835b Merge pull request #1415 from kunalkushwaha/minor-fmt-fix
8f7086a8bd unused fmt package
96a75ab1ab Move detach flags to platform specific
f74cea71dd Update basic test to allow being run in parallel on client
750771f6d0 Remove snapshot test suite as a parallel test runner
502734116d Update loopback to return error
4028add553 Merge pull request #1405 from crosbymichael/fifos
4015f7376f Merge pull request #1410 from mlaventure/errdegs-stack
0e1f6c5da6 Merge pull request #1394 from crosbymichael/test-io
fc535efe58 windows: Close IO if process in created state
01b217f884 Merge pull request #1411 from estesp/snapshotter-cli-default
4712ed5390 Fix snapshot ctr command to use default
a8b21da538 Add FifoIO to expose fifos directly to client
1b470c180e Remove Stdio usage in tests
4de219903a errdefs: Provide a valid stack in all cases
10460647f2 Merge pull request #1392 from cpuguy83/wait_async
6ab99edb71 Convert `ExitStatus` to use fn to get details
0648ec3ead Merge pull request #1388 from kunalkushwaha/makefile
026896ac4c Make Wait() async
1c989588c0 Breaking Makefile into platform specific files
89da512692 Merge pull request #1377 from crosbymichael/exec-delete
c71066252b Ensure content writer only unlocks resource once
853fd15115 Merge pull request #1407 from crosbymichael/cgroups-bump
bf82de3a4e Allow exec process to be deleted in created state
77836a6c27 Update cgroups to e6d1aa8c71c6103624b2c6e6f4be0863
873a34649a Merge pull request #1366 from stevvooe/containers-metadata-tests
3e81b092de Merge pull request #1406 from mlaventure/add-exitedat-to-process
8a1b03e525 Add ExitedAt to process proto definition
4c5f824167 Merge pull request #1404 from WeiZhang555/add-newline
14fe2d5f20 Add newline char to avoid mix of logs
677257f032 service/snapshotter: move default to client
783ed05057 metadata: ensure correct updates on Container
8095244c26 Merge pull request #1396 from crosbymichael/reverts
4950c26757 Revert "Wait for client side copy goroutines to start"
e3696cfb4e Merge pull request #1395 from dmcgowan/content-testsuite-cleanup
42119539be Close writers in content test suite
2fa366d6af Add support for multiple differs
567c2758f8 Merge pull request #1391 from crosbymichael/stdin-block
cc3b7a5e9a Revert part of 06dc87ae59cca1536a3a98741a267af687b6dcdd
0c10ce01c9 Merge pull request #1390 from AkihiroSuda/fix-typo
5f7c527ed5 client: Resoveconf -> Resolvconf

v1.0.0-alpha5

containerd 1.0.0-alpha5

Another release brings further stability. Several quality fixes are
included in this release, which include a fix to memory leaks, race
conditions and error handling. The documentation has also been rounded
out.

Please download the binaries provided and let the bears get at 'em.
Please report issues through
https://github.com/containerd/containerd/issues. Your feedback is
extremely important at this stage, so please don't be bashful about
letting us know what you think.

Upgrading

The `runc` version has been upgrade. Make sure to update your `runc` to
the version called out in [RUNC.md](RUNC.md). No other changes should
have to take place on upgrade.

Release Process

The release process and versioning guarantees have been laid out in
[RELEASES.md](RELEASES.md). It identifies the release process,
versioning, branching, support horizon and backporting processes for
containerd.

If there are components missing or questions, please report them in an
issue or propose changes via a PR.

Stress Tool

The `containerd-stress` tool can now be used to put `containerd` through
its paces. Fire it at your instance today!

Contributors

A special thanks to the contrubutors of this release:

Abhinandan Prativadi
Akihiro Suda
Christopher Jones
Derek McGowan
Ian Campbell
Jess Valarezo
Kenfe-Mickaël Laventure
Lantao Liu
Michael Crosby
Phil Estes
Stephen J Day

Changes

b2ee0ab3 Merge pull request #1387 from stevvooe/alpha5
a7445504 release: prepare for 1.0.0-alpha5
0fd951c2 Merge pull request #1379 from crosbymichael/profile
a29c6c7a Merge pull request #1386 from
Random-Liu/task-service-grpc-error
f79981c2 Convert errors returned by task service to errdefs error.
0a188014 Merge pull request #1382 from stevvooe/update-api-descriptors
15f56727 Merge pull request #1369 from AkihiroSuda/ctr-snapshot-view
c890ca9b Merge pull request #1383 from stevvooe/document-config-function
2a1f7b64 images: document config utility function
8ae20a13 api: update protobuf descriptors
e800f08f Change oom metric to const
ed1c4042 Merge pull request #1372 from jessvalarezo/d4m-gettingstarted
d8abb61b Update building doc for Docker for Mac users
89daacfe Merge pull request #1370 from crosbymichael/daemon-lock
240a7be6 Merge pull request #1371 from dmcgowan/btrfs-test-errors
06dc87ae Wait for client side copy goroutines to start
bfd62ceb Defer unlock for testing daemon
73ac66ee Merge pull request #1352 from ijc/userns
0e28f2c7 Update mount creation to only use btrfs subvolume id
ebafab47 correct container "/" ownership with userns
e03ecd30 ctr: add `ctr snapshot view`
4703b99a Merge pull request #1364 from
AkihiroSuda/fix-ctr-snapshot-commit
62cebf9f Merge pull request #1365 from AkihiroSuda/stress
f8b1f4f6 stress -> containerd-stress
ca352220 ctr: fix `ctr snapshot commit`
a64399ac Merge pull request #1341 from
mlaventure/enable-test-parallelism
72159bf4 Merge pull request #1325 from dmcgowan/diffid-labels
2abaf6e9 Fix possible deadlock in WithProcessKill
b02e9a84 Fix TestContainerNoBinaryExists on windows
104a8088 Add integration-parallel to Travis & AppVeyor CIs
eb0970bb Mark relevant tests as elligible for parallelism
938810e7 Merge pull request #1311 from abhinandanpb/client_int
ca6b4632 Merge pull request #1343 from Random-Liu/change-io-to-interface
dbb63b63 Merge pull request #1346 from stevvooe/disallow-runtime-update
8e2c95f9 Change IO to interface.
c288fbe9 Merge pull request #1354 from crosbymichael/null-io
6a4a09d3 Merge pull request #1351 from jessvalarezo/check-nil-spec
eb58ecab Add null io option
cf1b5934 Merge pull request #1348 from AkihiroSuda/remove-unused
e5cf1471 metadata: container spec nil check
77035a6e Merge pull request #1345 from crosbymichael/gorunc
4e233779 rootfs: remove unused functions
ca9dec32 Merge pull request #1329 from tophj-ibm/change-test-image
7a5d5923 Exposing helpers to access internal structure
a3801b73 Merge pull request #1344 from crosbymichael/ops
d7689418 metadata: disallow changing the runtime of an existing container
da34812d Update differ to support compressed archives
fa3454e5 Update go-runc to b85ac701de5065a66918203dd18f05
dee8dc2c Add support for content labels on commit
c4387a15 Add content test suite run to client
b1eb1103 Add section for `state` dir
edc51c86 Merge pull request #1342 from mlaventure/is-serving-failfast
f2ee71c5 Merge pull request #1339 from dmcgowan/refactor-oci-package
fed5ad4b Update tests to properly use IsServing
7de9ca51 Disable FailFast on client.IsServing()
661bcd3e Change test image based on platform
a437d140 Remove oci package
a6be9f54 Merge pull request #1338 from mlaventure/client-reconnect-fix
5f36ac20 Add test to ensure we can access tasks on restart
e661be6a Fix failure to connect to shim on daemon restart
7ac351cd Share Dialer and DialAddress between client and shim
587a811d Check credentials when connecting to shim
24aac336 Update unix dialer to keep retrying if socket is gone
bb443241 Merge pull request #1331 from crosbymichael/stress
f27f8dd1 Merge pull request #1320 from crosbymichael/cr-race
c7f04ce0 Merge pull request #1310 from stevvooe/releases
9827b4c1 RELEASES: define the release process
d513dd2b Fix race with task checkpoint
fd75f1e5 Add stress test tool

v1.0.0-alpha4

containerd 1.0.0-alpha4

With this weeks release, we are starting to become more stable. Many
fixes related to rounding out core features and usability. We have our
first documentation available, oriented towards getting started with
containerd.

This is the first release where we have no backwards incompatible
changes to the GRPC API. There are some changes to the metadata storage
layout, so please check upgrading for details.

Please download the binaries provided and let the bears get at 'em.
Please report issues through
https://github.com/containerd/containerd/issues. Your feedback is
extremely important at this stage, so please don't be bashful about
letting us know what you think.

Upgrading

With respect to the GRPC API, there have only been additions to add
labels to snapshot. All existing integrations should continue working
with this release without changes.

The storage format has had some changes to store labels and runc state
has been relocated. Removing the contents of `/var/lib/containerd` is
recommend before running this new version. This will cause loss of
containers and image data. Let us know if this is a problem.

Documentation

We now have guides for [Getting
Started](https://github.com/containerd/containerd/blob/master/docs/getting-started.md),
[Operations](https://github.com/containerd/containerd/blob/master/docs/ops.md)
and [Namespacing and
Multi-tenancy](https://github.com/containerd/containerd/blob/master/docs/namespaces.md).
Please take some time to read them and get to know containerd.

The [godoc](https://godoc.org/github.com/containerd/containerd) has also
been updated with new descriptions.

Snapshot Labels

Snapshots can now be decorated with labels on `Prepare`, `Commit` and
`Update`. This is useful to associated snapshots with various components
in containerd.

Snapshot Command

The arguments naming and order now correctly match the `Snapshotter`
interface. Ordering of arguments may be affected. Make sure to use the
help before using these commands if you are unsure.

State Directory

The runtime state directory has been brought back. Previously, this
stored ephemeral container data associated with running containers. It
was removed because checkpoint data was much too large for `tmpfs` used
for the the `/run` directory. The checkpoint data is now in the main
containerd directory, while the ephemeral data resides in
`/run/containerd`. Access performance for `runc` should increase and old
runtime data should be cleaned up on reboot with this change.

API stability

Tooling for GRPC API stability has been added. When protobufs are
built, the descriptors for the entire symbol set that make up the API
are aggregated into a single file. Changes that affect the API will show
in these files, making it much easier to identify differences that
aren't apparent in proto files. At each minor release, these files will
be snapshotted.

Go API Additions

While there are several changes to the Go API, a few highlights include
an option to kill the process process on delete, `WithProcessKill` and
the ability to set the cgroup path and hostname options on the the runc
specification.

Solaris Build Support

The project now builds on solaris.

Contributors

A special thanks to all those that contributed to this release:

Akihiro Suda
Edward Pilatowicz
Kenfe-Mickaël Laventure
Lantao Liu
Michael Crosby
Phil Estes
Stephen J Day
Tobias Klauser
Yanqiang Miao

Changes

56d499e1 Merge pull request #1335 from stevvooe/alpha4
875672ef release: prepare for 1.0.0-alpha4
70c2d367 Merge pull request #1328 from crosbymichael/ctr-runtime
a888587c Set runtime on container from ctr
258c719c Merge pull request #1327 from estesp/namespace-doc-fixes
f90fa4e1 Minor updates to the namespaces doc
7ddd6ad9 Merge pull request #1316 from crosbymichael/namespaces
7a40eaab Add namespace doc for containerd
921b830b Merge pull request #1322 from stevvooe/easy-install
17d7a5c6 Merge pull request #1321 from
stevvooe/refactor-snapshot-commands
67954062 Merge pull request #1326 from Random-Liu/fix-typo
debd07fc Minor typo fix.
7717eb6f Makefile: simplify installation from tar file
cea1d337 cmd/snapshot: follow conventions from Snapshotter
e6ba48f2 Merge pull request #1257 from stevvooe/content-changes
8be340e3 content: remove Provider.Reader
f3ff1e22 Merge pull request #1315 from crosbymichael/lchown
1f6b10b6 Use lchown when remapping rootfs
ef344c14 Merge pull request #1312 from tklauser/use-x-sys
f2bed8ff Use CopyFileRange from golang.org/x/sys/unix
4a6a2b9d Switch from package syscall to golang.org/x/sys
29a4dd7f Merge pull request #1276 from dmcgowan/snapshot-labels
ee027d4e Merge pull request #1309 from crosbymichael/opts-doc
67572b63 Merge pull request #1307 from crosbymichael/spec-opts
bed8df11 Add cgroup paths and hostname spec opts
1907116b Add doc for extending client opts
1f04edda Merge pull request #1306 from estesp/error-no-container
8ebbd1cd Delete command should require at least one container ID
42c1c9a9 Merge pull request #1301 from crosbymichael/task-force
d8c075aa Add WithProcessKill DeleteOpt
d4be9822 Merge pull request #1303 from estesp/cleanup-workdir
a2add745 Merge pull request #1302 from dmcgowan/fix-blob-by-tag-attempt
c8cd3d90 Fix bundle removal with the reappearance of state dir
2b0aa29c Avoid attemping blobs endpoint when digest is not provided
738c22a7 Merge pull request #1299 from crosbymichael/ctr
cdd03c98 Merge pull request #1300 from crosbymichael/ops
2fb2168b Merge pull request #1224 from epilatow/solaris.cc.20170719.0
56c1f5c1 Add solaris build support
00288bcb Update ctr containers and tasks command
a543d057 Add ops guide for containerd
f2ba04ff Set subreaper true in default linux config
e9b86af8 Merge pull request #1283 from mlaventure/resurrect-state-dir
fc941088 Merge pull request #1294 from crosbymichael/gettingstarted
b20fd92a Merge pull request #1298 from miaoyq/add-start-cmd
60f7eee2 Merge pull request #1275 from mlaventure/travis-ineffassign
a88397e9 Merge pull request #1296 from stevvooe/api-stability-tooling
d6c171ea Add getting started guide
ac72bbab Add `start` subcommand in `ctr`.
a73eb2b2 api: generate merged descriptors when building protobufs
e8625bcd Merge pull request #1295 from mlaventure/separate-client-opts
de7afd8a Merge pull request #1293 from dmcgowan/fix-snapshotter-run
56b18c1d Move client's options to separate files
5a74a46d Fix bug where snapshots got created with wrong snapshotter
6c1a04f3 Merge pull request #1292 from stevvooe/cleanup-protobuf-imports
bf913547 Merge pull request #1290 from Random-Liu/cleanup-io-properly
d986a187 api: cleanup protobuf imports
73735c4d Cleanup FIFOs on error.
bb39d1d9 Merge pull request #1289 from mlaventure/add-missing-return
308ebe7e Add missing return when failing to write tar header
99315f8e Merge pull request #1285 from crosbymichael/client-godoc
bce8fe7b Merge pull request #1288 from
mlaventure/dont-touch-grpclog-in-client
2eaf9117 Merge pull request #1279 from Random-Liu/cancel-context-on-wait
16f6e094 Do not touch grpc logger from within the packages
8fae8a5b Cancel event subscribe context in Wait.
0a85f6e4 Update godoc for client package
7e006332 Merge pull request #1282 from
AkihiroSuda/dismiss-progressbar-on-debug
ff15d18f Merge pull request #1287 from crosbymichael/exitstatus
0e97bdfe Merge pull request #1284 from mlaventure/use-tmp-console-socket
fdc5a475 Gate task.Wait status check on checkpoints
8700e23a Use root dir when storing temporary checkpoint data
9f13b414 Return exit status from Wait of stopped process
fbe4751b Use a temp socket to receive the console from runc
642620ca Resurrect State directory
829845d2 Fix ineffassign warnings
b45fb985 ctr: dismiss progressbar on --debug
534a137e vendor: update github.com/containerd/console
949d4903 vendor: update golang.org/x/sys
47637f2a vendor: update github.com/containerd/continuity
be36d26e Update windows snapshotter
24783b9e Add snapshot test suite for update
efca0c53 Update GRPC api to support labels and snapshot updates
55c3711f Update snapshot metadata to support labels
7d3a1e77 Add snapshot labels
ad72036e Refactor common boltdb fields to subpackage
78933003 Invoke ineffassign during CI
9526f536 Remove Windows cross compile from Travis

v1.0.0-alpha3

containerd 1.0.0-alpha3

Another released alpha brings us closer to a stable release! This
release contains more changes to the event system, cleanup of the
process execution model and several bug fixes.

Please download the binaries provided and light them on fire. Please
report issues through https://github.com/containerd/containerd/issues.
Your feedback is extremely important at this stage, so please don't be
bashful about letting us know what you think.

Upgrading

With changes to the `Tasks` service and the `Events` service, it is
recommend to full upgrade containerd and any constituent shim processes.
Running with previous versions may effect task startup and event
distribution from the shim.

These changes were done to ensure API consistency.

No changes to the `ctr` tool or storage formats should affect
compatibility.

If there are  changes that affecting compatibility that weren't listed
here, please file an issue.

Process Exec

More work has been undertaken to merge the behavior of container tasks
and exec processes. The `Task` object no longer exists. The user now
interacts with only processes. The main container processes is started
through `Start` method, while processes can be added to the container
with `Exec`.

Event Filters

Events now support full filtering. Filters act on events at publish
time, per subscriber, allowing a subscriber to receive only relevant
events. The same filtering syntax and behavior used on other APIs has
been added here except that we autogenerate the available fields using
protobuf definitions.

The following example will match all events having to do with tasks in
the `bb` namespace:

```console
$ ctr events 'topic~=/tasks/.+,namespace==bb'
```

Event specific data can even be selected upon. The following example
will match *any* event that has a `container_id` field with the value
`mycontainer`.

```console
$ ctr events 'event.container_id==mycontainer'
```

The above will actually decode event data, if known to containerd, and
match regardless of the particular type, allowing this to act on
unrelated event types without changing syntax.

Events API

The `Publish` method no longer takes an `Envelope` message as an
argument and a new `Forward` method has been added. While this change
seems superficial, it actually has the effect of avoiding a
serialization round trip when forwarding events from other backends,
such as container shims.

This change is not backwards compatible with previous alpha releases.

Unmanaged Root Filesystem

Container's can now be run without snapshots using the `ctr` tool. If
the `--rootfs` flag is provided, the positional argument for image will
now be interpreted as a filesystem path. The following is an example:

```console
ctr run --rootfs --tty /my/root/fs mycontainer
```

Shim CGroup

Container shims may not be started in a specific cgroup with a parameter
passed at task creation time.

Changes

0fa76584 Merge pull request #1280 from stevvooe/alpha3
916254e4 release: prepare for 1.0.0-alpha3
c8b4e4db Merge pull request #1277 from crosbymichael/tty-block
ee2dea2b Merge pull request #1278 from stevvooe/update-oci-spec
bf4838eb Shutdown console after process exits
610e1a25 vendor: update OCI image-spec dependency
8b0a0400 Merge pull request #1268 from crosbymichael/exec-state
f945cdc7 Update windows locking code
d18af869 Update for epoll console handling
e827adaf Update windows with exec create/start actions
83b27db9 Check status for stopped processes before wait
cd00216f Rename TaskStatus to Status
504033e3 Add Get of task and process state
2974e485 Add no-criu flag for running tests
9f089656 Change Exited/Status to SetExited/ExitStatus
a2a34519 Implement Exec + Start for tasks service
63878d14 Add create/start to exec processes in shim
2533bfea Merge pull request #1271 from stevvooe/autogenerate-fieldpaths
c857ba2d events: autogenerate fieldpath filters
bb7b41ad Merge pull request #1269 from stevvooe/plumb-correct-interfaces
7ed88c1e linux/shim: use events.Publisher interface
92d737f4 Merge pull request #1259 from dqminh/epoll-io
834f55df Merge pull request #1264 from stevvooe/event-filters
af2d7f0e events: initial support for filters
4ba6d8e5 Merge pull request #1267 from crosbymichael/bump-runc
2386062c Update runc to e775f0fba3ea329b8b766451c892c41a3d4
ce07fa04 Merge pull request #1263 from crosbymichael/no-shim-events
f86d5ae0 Merge pull request #1262 from dmcgowan/more-snapshot-tests
7b6ff6ec event forwarding without shim
8e534658 use epoll to manage console i/o in linux
d28126f0 Handle kernel related ci failure
a7c44f00 Add snapshot test cases for former issues
20fa6aee Merge pull request #1182 from AkihiroSuda/rootfs
183a6ca8 Merge pull request #1013 from AkihiroSuda/oci-export
de2671b7 bump vendor for containerd/console update
b518f11d client: add Import() and Export() for importing/exporting image
in OCI format
752d253f client, ctr: allow specifying unmanaged rootfs dir
1a054c67 Merge pull request #1134 from crosbymichael/shim-cgroup
4e299a9a Merge pull request #1254 from stevvooe/close-channel
16797276 Merge pull request #1230 from
dmcgowan/snapshot-client-testsuite
fdea1cea Merge pull request #1256 from
dmcgowan/fix-ingest-file-not-exists
afe0ce35 Merge pull request #1255 from stevvooe/multi-delete
585f7d64 Skip test on windows
ccbb0352 Convert file not exists to status not found
83ac8748 cmd/ctr: allow deleting multiple containers at once
a1f75096 events: close channel explicitly
98a86c4d Add ShimCgroup path for placing shim in cgroup
d4349eff Merge pull request #1251 from crosbymichael/apparmor
a0a5cc77 Add user namespace support to client
c3872b84 Move RootPath to fs package
da5c72c3 Run snapshot test suite for metadata and client

v1.0.0-alpha2

containerd 1.0.0-alpha2

With another week comes another alpha release. With this release, we have
focused on increasing overall quality and consistency across the code base.
Several new tests have been added, along with attention to refactoring in
various subsystems to match current needs.

Unfortunately, we had to break some interfaces to achieve these goals. See the
section on Upgrading for details.

Again, please download the binaries provided and kick the tires. Please report
issues through the https://github.com/containerd/containerd/issues. Your
feedback is extremely important at this stage, so please don't be bashful about
letting us know what you think.

Upgrading

Some backwards incompatible changes have been made to the GRPC API and the
snapshotter storage format. See the sections on Events and Snapshotters for more details.

To upgrade, you'll need to clear out the containerd root, which defaults to
`/var/lib/containerd/`. All containers, images and metadata will be lost, if
you do this. If this is a problem, please reach out and we can work out a
migration script. If such a change was done from a production release, a
migration script would have been provided.

Also, make sure to update your clients to the latest version that picks up the
new definition for the events service. This change would not be accepted in a
full released version.

Events

After dealing with a few deadlock issues, the events subsystem has been
completely refactored to match the existing use cases. Specifically, a lot of
cruft around the original design, based on Go's context package has been
removed. The use of go-events has been cleaned up to ensure correct
subscription and distribution of events, in addition to ensuring correct
teardown.

The nomenclature has also been updated to better reflect familiar "publish" and
"subscribe" models. If you closely examine #1246, you'll see that the usage of
the `Publisher` interface is much simpler than the `WithTopic` approach. This
should allow us to add events to more subsystems.

The GRPC API for the Events service was updated to bring the service inline
with these changes. Post and Stream have been replaced with Publish and
Subscribe, respectively. Clients will have to be updated to use the new API
endpoints.

After these changes, adding proper filter support should be more
straightforward.

See a615a6fe for details.

Snapshotter

Previously, snapshots had an attribute `Readonly` that was only valid for
`Active` snapshots. After looking at various conditionals, snapshot behavior
and usage, we found that these snapshots were better represented as a discrete
type, known as a "view snapshot".

Unfortunately, we've add to break compatibility with the existing storage
format to correctly enumerate the snapshot types. Users will have to remove the
old storage and start from the scratch.

See 863784f9 for details.

Tar

Tars with duplicated symlinks in disparate layers are now handled correctly.

See afec478b for details.

- Windows support
- snapshot command now supports "commit"
- More testing

Windows Support

Progress on supporting windows has received a major boost. Windows integration
has been refactored to more closely follow existing changes throughout
containerd.

Commands

A new command has been added to `ctr snapshot` to allow committing of active
snapshots. The help output has been reordered to be alphabetical.

Changes

856b0384 Merge pull request #1253 from stevvooe/alpha2
997a1b5a release: prepare for v1.0.0-alpha2
b84817a2 Merge pull request #1246 from stevvooe/events-refactor
03623285 Merge pull request #1248 from dmcgowan/snapshot-storage-kind-test
366ebfd6 Merge pull request #1249 from dmcgowan/client-rename-with-rootfs
c7cc6ad2 Add root mounts to task info
73bec3ed client: rename rootfs to snapshot in "With" functions
a615a6fe events: refactor event distribution
6012f504 Update storage kind test
9434bf9e Merge pull request #1236 from stevvooe/snapshot-column-kind
050c7d24 Merge pull request #1247 from darrenstahlmsft/revendorMicrosoft
cec6331e Revendor hcsshim and go-winio
1251413a Merge pull request #1245 from dmcgowan/archive-more-tar-fixes
afec478b Update tar path resolution
863784f9 snapshot: replace "readonly" with View snapshot type
a9ab45fb Merge pull request #1241 from stevvooe/allow-resumable-upload
bfe747da Merge pull request #1242 from mlaventure/appveyor-no-coverage-only-master
f5bd8bbb Merge pull request #1243 from crosbymichael/reg-diff-urls
a3769f88 Panic when registering the same type but diff urls
219c3e39 Disable coverage tests on Windows CI
2eaac710 Only run Windows CI on master branch
d0e396aa metadata: defer ingest lock to backend
c52523c4 Merge pull request #1238 from crosbymichael/reg-specs
f98b2979 Merge pull request #1239 from crosbymichael/roadmap
ba577f71 Merge pull request #1227 from tossmilestone/fix-comment-typo
becf0015 Replace roadmap with link to milestones
b7e0101b Merge pull request #1228 from dmcgowan/content-testsuite
228f7d45 Register spec types in client
8e1591bd Call upload status tests
bb3c9c59 Rename content/fs to content/local
938f3185 Add content test suite
44236524 Move content store implementation
9b53b8b6 Merge pull request #1237 from WeiZhang555/remove-hardcoded-str
adeec483 Replace hardcoded debug address with const var
856c351f Improve the comment
4118a256 Merge pull request #1234 from dmcgowan/update-logrus
14912932 Update dependencies for logrus rename
1d2a079f update to github.com/sirupsen/logrus v1.0.0
dd7642fc Merge pull request #1196 from mlaventure/update-windows-runtime
a2df6d1a Merge pull request #1141 from ijc/rootfsPropagation
0f6959a2 Merge pull request #1160 from darkowlzz/1082-snapshot-commit
a6211858 Merge pull request #1179 from AkihiroSuda/makefile-i
aeab9355 Fix vet errors
eb4e0b5f Add AppVeyor configuration
e3fcde69 Fix deadlock in events service
5ea5fbdf Fix deadlock in TestContainerExec if `process.Wait()` fails
d4e780d7 Ensure tasks are started when running tests
3df07cbc Cancel io if task is deleted without being started
8e12d1fc ctr: Allow deleting a container in the Created state
4d14bfd8 go-winio: Don't increment the wait count if the file is closing
7f786cf0 go-winio: Prevent Data Race when accessing closing
db1b0a2a Update go-winio to v0.4.3
651aaff7 Update integration test to support windows
79d04ded Make integration a bit more verbose
b2d9db2e windows: Use runtime event topic constants
5c8e0efb windows: Add servicing code
4bb9ac28 Sort ctr commands alphabetically
d0166c42 Register content command with ctr
d10c62d4 Wrap typeurl returned errors with the provided url/type
5fd004a1 Update vendoring
546f0451 Update errdefs.ErrInvalidArgument message
674b460d Move typeurl registrations to runtime package
a4aaa09c Update ctr so it works again on windows
61fbd231 windows: Refactor whole code
fc82e149 windows: Move runtime options out of the spec field
acf863a0 windows: Rely on the OCI specs instead of custom type
bff040d0 windows: Ensure pids are not reused if active
d42cb88b Loop umount'ing rootfs until there are no more mounts
d63d2ecf Simplify mount cleanup on failure by using defer
300f0831 Cleanup mounts if we fail to mount one element of rootfs
8b365117 containerd-shim: Do not remount root MS_SLAVE
912ddbae cmd/ctr: add commit command to snapshot
b6dbbd33 Fix typo error in Protobuild.toml
7822819f .travis.yml: run go build -i
f72e97db Makefile: `go build -i` -> `go build`

v1.0.0-alpha1

containerd 1.0.0-alpha1

We have followed up the initial alpha with this second release. There are a
large number of changes to focus on API stability, error handling and several
bug fixes.

Again, please download the binaries provided and kick the tires. Please report
issues through the https://github.com/containerd/containerd/issues. Your
feedback is extremely important at this stage, so please don't be bashful about
letting us know what you think.

Commands Merged

The most visible changes to users will be that the `dist` command has now been
merged into `ctr`. We've found this to be much easier for demonstration,
testing and deployment. For the most part, this change has moved the
subcommands untouched under `ctr`.

In addition to the command merge, all commands that mutate labels were changed
from `set-labels` to the shorter `label`.

The `snapshot` command has a few additions to display details in a tree format,
as well as some tweaks to expose mounts. See 659e3d78 and 4dc02c09 for details.

Since we are discussing command syntax, it is a good time to remind
users that cli behavior will not be covered by the 1.0 version
guarantees. We will only guarantee behavior of GRPC APIs, although we'll
try to keep changes like this minimized.

Event Topics

The topics for task events have been tweaked to be more consistent. This could
effect users that were matching on event topic. Please see a578730a for
details.

Changes

A full list of changes is provided for your convenience:

0b3e572b Merge pull request #1221 from stevvooe/alpha1
6273d79c containerd: prepare for v1.0.0-alpha1
28bb2b35 Merge pull request #1220 from stevvooe/release-target
88656970 Makefile: add release target
28e8d95a Merge pull request #1210 from dmcgowan/use-forked-tar
72c59aeb Merge pull request #1154 from darkowlzz/1082-snapshot-prepare
14e10c87 Merge pull request #1214 from jovizhangwei/fix
b5267baa Merge pull request #1216 from tklauser/prctl-x-sys-unix
834cafc2 Merge pull request #1206 from AkihiroSuda/improve-btrfs-error
70dc92f1 Merge pull request #1217 from fate-grand-order/fixed
0600753b Merge pull request #1208 from dmcgowan/tar-test
648f82e4 Merge pull request #1211 from stevvooe/no-build-proto
d3d1987f correct some misspellings to make Go Report more happy
4dc02c09 cmd/ctr: add mount subcmd to snapshot & a flag in prepare
bfa4b901 Use Prctl() and associated constants from x/sys/unix
50c84c4d Claim Go 1.8.x version requirement in BUILDING.md
e76357cb btrfs: improve an error string
a8504277 Merge pull request #1209 from stevvooe/remove-errors
23aa4910 Use forked archive/tar package
60792458 Replace uses of filepath.Join in Apply
35d59004 Merge pull request #1207 from mlaventure/update-linux-events-topic
1ecb2ea3 linux/shim: remove redundant topic prefix
8d195132 Merge pull request #1195 from darkowlzz/tree
e3a07b56 Makefile: no need to build protos binary
6d0bcd5a linux, linux/shim: remove error definitions
4a3f98cb Add link breakout checks and tests
805654ab Merge pull request #1178 from rajasec/ctr-run-error
728f8acc Fixing return error on run command
123aab86 Merge pull request #1202 from stevvooe/add-go-report-card
59b0fc31 Merge pull request #1204 from fate-grand-order/typo
e4beb7c5 Use constants for runtime event topics
a578730a Update linux events topic
58dfd56a fix some typos for reference/reference.go
4888d40a Merge pull request #1203 from stevvooe/containerd-startup-version
659e3d78 cmd/ctr: add tree subcommand in snapshot
6cfdbb2a README: add go report card badge
2a923f72 cmd/containerd: show version and revision on startup
6d305c74 Merge pull request #1200 from stevvooe/image-is-found
778b1f1c cmd/ctr: container list should not look up image
52927e59 Merge pull request #1199 from dmcgowan/socket-directory-permissions
528a9d87 Create socket parent directory with correct permissions
afd533de Merge pull request #1197 from dmcgowan/fix-snapshot-client-panic
fb7af302 Merge pull request #1198 from stevvooe/mark-ociimageconfig-childleess
9f654b08 images: OCI image config is a childless data type
a220fb6b Fix panic in snapshotter when connection fails
81b893ac Merge pull request #1194 from AkihiroSuda/nit-comment
a0664b5c comment: dist -> ctr
e48ef84b Merge pull request #1190 from stevvooe/remove-dist-command
98f6deb5 cmd/dist: completely remove dist command
751598e8 Merge pull request #1189 from stevvooe/move-content-commands
1db80ed9 cmd/{ctr, dist}: move content command to ctr
695351f3 Merge pull request #1188 from stevvooe/move-images-command
1905380a Merge pull request #1187 from stevvooe/use-protobuild
f7306d7f cmd/{ctr,dist}: move images command to ctr
d50e4bcd Merge pull request #1183 from mlaventure/move-tasklist-to-runtime
6c925924 protobuild: replace protobuild command
31324e54 Merge pull request #1181 from mlaventure/fix-races
a5b3038c Fix deadlock when task's exec start fails
9dcf725b Fix data race when task's exec fails to start
ae334b04 Prevent a data race in client_test.go on test failure
bf679063 Merge pull request #1186 from estesp/update-fifo-racefix
5e594d03 Update containerd/fifo for race fix
56a4023a Merge pull request #1184 from stevvooe/label-commands
a8b22549 cmd/{ctr,dist}: label can be a verb
88c1db5c Move taskList to the runtime package

v1.0.0-alpha0

containerd 1.0.0-alpha0

We are pushing the first containerd alpha release today.  It includes a fully
functional execution, content, snapshotting filesystems, and distribution
layer.

With the alpha release we wanted to make sure the GRPC API was in a good shape
for people to start or finish the integrations for the 1.0 branch.  Ideally,
there will not be any major API changes after this release.

We encourage users integrating containerd into their software and platforms to
use our Go client, `import "github.com/containerd/containerd"`.  We have not
finalized this Go API at the time of the alpha release so that users can
provide feedback and modifications can be made to the client to reduce code
that containerd consumers have to write.

During the alpha period, we will be working on integrating containerd into
various projects and working out any rough edges or bugs.  We will also be
tagging a weekly alpha release going forward with fixes and updates during this
phase.

v0.2.9

v0.2.8

v0.2.6

v0.2.7

v0.2.5

v0.2.4

v0.2.3

v0.2.2

v0.2.1

v0.2.0

v0.1.0

0.0.5

0.0.4