image-spec: tag b472d5f as v1.0.0-rc1 (accepted)

image-spec: tag b472d5f as v1.0.0-rc1 (closes Fri Oct 7 16:59:29 UTC 2016)

Update with recent motions (image-spec v0.5.0, etc.)

Although the image-spec vote drifted significantly between the initial
proposal to tag 67521f5 (based on 72d0525) and the tagged aed55bc.
Changes in that gap that were ambiguously covered by the vote:

  image-spec$ git log --graph --oneline --decorate 67521f5..aed55bc
  * aed55bc (tag: v0.5.0) version: v0.5.0
  *   8d0ee71 Merge pull request #257 from coolljt0725/fix_media_type
  |\
  | * 0a76d61 (origin/pr/257) Add license head to manifest_test.go
  | * 5c9e424 Fix media type on unpacking layer
  *   61989fe Merge pull request #278 from xiekeyang/error-value
  |\
  | * 85bbf42 (origin/pr/278) improper error description
  *   8c2642e Merge pull request #290 from stevvooe/better-wording-to-introduce-media-types
  |\
  | * d5fd2d8 (origin/pr/290) media-type: clarify that we have MIME-compatible media types
  * |   ec62652 Merge pull request #291 from stevvooe/break-sentence
  |\ \
  | * | c2b9e7f (origin/pr/291) media-types: break up sentence into multiple lines
  | |/
  * |   d564f8e Merge pull request #284 from TrumanLing/fix-typo
  |\ \
  | * | 6304f58 (origin/pr/284) README: Fix "can then discovered" -> "can then be discovered"
  |  /
  * |   5553ed5 Merge pull request #221 from x1022as/descriptor
  |\ \
  | |/
  |/|
  | * 75a51ed (origin/pr/221) fix regular expression of algorithim
  * 5a0447a Merge pull request #169 from runcom/layer-urls
  * 64e7a30 (origin/pr/169) descriptor: add urls property

The runtime-spec vote (nominally for c678086) was closer to the
target, tagging 7dab1a2:

  runtime-spec$ git log --graph --oneline --decorate c678086^..7dab1a2
  * 7dab1a2 (tag: v1.0.0-rc2) version: 1.0.0-rc2
  * 009e969 (origin/release-v1.0.0-rc2) ChangeLog: Document changes since v1.0.0-rc1
  * c678086 Merge pull request #553 from RobDolinMS/patch-11
  * 9da8967 (origin/pr/553) [ReadMe] Just one level/tier of compliance (rebase)

runC: Tag 6df383c2f881fbdeb as 1.0.0-rc2 (rejected)

image-spec tag 2bae0dc as v0.4.0 (accepted)

project-template: Merge governance and release docs at 56abe122 (accepted)

project-template Merge governance and release docs at 56abe122

Replace the three per-project threads with a single thread on
the v3 proposal.

image-spec tag ca58cdf as v0.3.0 (accepted)

Tag motions and their resolutions

So it's easy to see how email-based voting is being used.

Idempotent pause/unpause (obsolete)

Pause/unpause were dropped from #225 [1,2,3] before it landed as
7117ede7 (Expand on the definition of our ops, 2015-10-13).

[1]: https://github.com/opencontainers/runtime-spec/pull/225#issuecomment-155245857
[2]: https://github.com/opencontainers/runtime-spec/pull/225#issuecomment-169129261
[3]: https://github.com/opencontainers/runtime-spec/pull/225#discussion_r50442396

OCI Bundle Digests Summary (obsolete)

This was spun off into a new project at [1] around 2016-04-04.

[1]: https://github.com/opencontainers/image-spec

Labels and extension metadata (fixed)

The spec now has opaque 'annotations', although:

* It's a map[string]string and I would have prefered an
  opaque-in-the-runtime-spec type for an opaque-to-the-runtime
  field [1].
* It doesn't address arbitrary bundle content [2], but I have a
  separate tag for that [3].

[1]: https://github.com/opencontainers/specs/pull/331#issuecomment-192477931
[2]: Message-ID: <20151231045437.GA6362@odin.tremily.us>
     Subject: Re: Labels and extension meta data in containers #108
     Date: Wed, 30 Dec 2015 20:54:37 -0800
[3]: Message-ID: <20150826195447.GX21585@odin.tremily.us>
     Subject: Dropping the rootfs requirement and restoring arbitrary bundle content
     Date: Wed, 26 Aug 2015 12:54:47 -0700

removal of /run/opencontainer/containers (fixed)

This was dropped in favor of a 'state' operation, which landed in
v0.4.0 [1,2].

Although I'd prefer we'd have used --state and gotten out of the
state-registration business entirely [3,4,5].

[1]: https://github.com/opencontainers/specs/pull/225
[2]: https://github.com/opencontainers/specs/releases/tag/v0.4.0
[3]: https://groups.google.com/a/opencontainers.org/d/msg/dev/q6TYqVZOcX8/W1RVyCXCCQAJ
     Subject: Re: removal of /run/opencontainer/containers, add --state?
     Date: Tue, 8 Dec 2015 15:49:57 -0800
     Message-ID: <20151208234957.GK2767@odin.tremily.us>
[4]: wking/oci-command-line-api#14
[5]: https://github.com/opencontainers/specs/pull/225#issuecomment-172606567

Adopted-charter scoping (fixed)

I'd asked for the OCI Scope Table [1], and today Michael Dolan added a
link [2].

[1]: Message-ID: <20151208201013.GF2767@odin.tremily.us>
     Subject: Re: OCI News (scoping)
     Date: Tue, 08 Dec 2015 12:10:13 -0800
[2]: Message-ID: <E1A1821F-4654-41E6-9C49-4DA6186F201F@linuxfoundation.org>
     Subject: Re: OCI News (scoping)
     Date: Fri, 4 Mar 2016 18:32:59 -0500

opencontainers/ocitools (fixed)

That repo is established now, and the OCT folks are getting
together with Mrunal to fill it in.

Single, unified config file (fixed)

My pull request landed on 2016-01-27 in 9017a6c [1].

[1]: https://github.com/opencontainers/specs/pull/284#event-528492741

Separate config entries for device mknod and cgroups (fixed)

My pull request landed on 2016-01-27 in 608cb7b [1].

[1]: https://github.com/opencontainers/specs/pull/298#event-529014010

opencontainers/ocitools (m/ocitools & h/oct merge)

Purpose of config.json (runtime-mutations)

Recording style and policy in opencontainers/specs (fixed)

My pull request landed on 2015-01-08 in 6aa53ed [1], although it
missed the 0.2.0 tag [2].

Scoping is still waiting on feedback about "OCI Scope Table"
referenced in the adopted charter [3].

[1]: https://github.com/opencontainers/specs/pull/287#event-509700129
[2]: https://github.com/opencontainers/specs/pull/294#issuecomment-171106678
[3]: Message-ID: <20151208201013.GF2767@odin.tremily.us>
     Subject: Re: OCI News (scoping)
     Date: Tue, 8 Dec 2015 12:10:13 -0800

Exposing platform defaults

More detail for process.terminal?

Unify container-process and hook-process structures

Idempotent pause/unpause

Opt-out for /sys and /proc

I still feel like these should be opt-in, but the consensus is that
they should be opt-out [1].  That is currently blocking on suggested
syntax around that opt-out.  My suggestion [1] was to borrow the
maskedPaths syntax from [2], but I haven't heard any direct responses
to that.

[1]: Message-ID: <20151216215513.GG25571@odin.tremily.us>
     Subject: Re: Linux: Don't mount /sys and /proc (i.e. rolling back specs#164)
     Date: Wed, 16 Dec 2015 13:55:13 -0800
[2]: https://github.com/opencontainers/specs/pull/186
     Subject: Masked paths setting in the container

Adopted charter issues

I posted these messages pointing out issues I see in the charter after
its adoption was announced [1].  The opencontainers/web repository has
not been updated since 2015-07-24, and Vincent suggests it may be dead
[2].  I asked how I should submit changes [3], and have not received a
reply.

Before adoption, folks who belonged to a member company were suggested
to go through their company representative, and folks without a member
company were recommended to contact Mike Dolan
<mdolan@linuxfoundation.org>.  However, Rob Dolin contacted me shortly
after that meeting asking for pointers to my opencontainers/web pull
requests, and most of those ended up landing in some form or other in
the adopted charter.

I'll probably wait until we elect a TOB and ping them, but
until then I'll tag these issues to reduce the likelyhood of duplicate
reports.

[1]: Message-ID: <CAN6Zp5xR+TY2YnpyGmcsmnDOXfm9JBuaYPjaUEWU+zpAfrseVg@mail.gmail.com>
     Subject: OCI News
     Date: Tue, 08 Dec 2015 10:01:59 -0500
[2]: Message-ID: <CAN6Zp5wQQ8fGpXkri65xitJ2iEf2p8CEGo5gy2v5=K=gKkU-SA@mail.gmail.com>
     Subject: Re: OCI News (official charter)
     Date: Tue, 08 Dec 2015 11:58:23 -0500
[3]: Message-ID: <20151208194504.GD2767@odin.tremily.us>
     Subject: Re: OCI News (official charter)
     Date: Tue, 08 Dec 2015 11:45:04 -0800
[4]: http://ircbot.wl.linuxfoundation.org/meetings/opencontainers/2015/opencontainers.2015-09-30-17.00.log.html#l-59

Adding the PID namespace inode to state JSON

Labels and extension metadata

This thread came from an issue that is still open [1], so I'm tagging
it.  My personal feeling is still "this is out-of-scope, use an
orthogonal spec and load it in as arbitrary bundle content [2]" [3].
But the issue is still alive and fluxy, and I was just talking about
it with Vincent in #opencontainers on 2015-12-18.

[1]: https://github.com/opencontainers/specs/issues/108
[2]: Message-ID: <20150826195447.GX21585@odin.tremily.us>
     Subject: Dropping the rootfs requirement and restoring arbitrary bundle content
     Date: Wed, 26 Aug 2015 12:54:47 -0700

Recording style and policy in opencontainers/specs

Add the pull-request tag now that I've filed [1].

I'm not sure if the feature tag fits all that well, but we need it to
show up in the current status-config.json filters.

[1]: https://github.com/opencontainers/specs/pull/287

Defining "container" and "container processes" on Linux

We'll need something like this for the signal/pause/resume actions
briefly referenced in the landed lifecycle [1].  See also the
discussion around stop action implementation [2].

[1]: https://github.com/opencontainers/specs/pull/231/files#diff-b84a8d65d8ed53f4794cd2db7e8ea731R48
[2]: https://github.com/opencontainers/specs/pull/225/files#r41900150

Live Container Updates

Tag this thread, which is in the early stages of collecting a thought
that has been kicking around informally for a while (e.g. lots of
"yeah, that would be nice" comments in meetings [1,2]).

[1]: https://github.com/opencontainers/specs/wiki/MeetingMinutes:-2015-07-22#topics-to-discuss
[2]: https://github.com/opencontainers/specs/pull/230/files#diff-38574c080d4e2eb38c49b86e6588ad98R50

removal of /run/opencontainer/containers

Tag this thread, which has an external-repo command line API
suggestion in [1].

[1]: https://github.com/wking/oci-command-line-api/pull/14

Single, unified config file

Tag this thread, which didn't get any pushback, and is now a pull
request [1].

[1]: https://github.com/opencontainers/specs/pull/284

Make runtime cgroups optional

This allows folks to develop other cgroup managers outside of the
runtimes, which is a prerequisite for cgroup removal [1].  I feel like
there's a consensus on this issue, so I filed a pull-request [2], but
it was punted back to the list [3].

[1]: Message-ID: <CAD2oYtO1RMCcUp52w-xXemzDTs+J6t4hS5Mm4mX+uBnVONGDfA@mail.gmail.com>
     Subject: removal of cgroups from the OCI Linux spec
[2]: https://github.com/opencontainers/specs/pull/237
[3]: https://github.com/opencontainers/specs/pull/237#issuecomment-152294240

removal of cgroups from the OCI Linux spec

Tag this thread.  The current consensus seems to be "that may be a
good idea, but we want a solid replacement before pulling the current
requirements" [1].

[1]: Message-ID: <20151223162834.GK9470@odin.tremily.us>
     Subject: Re: Live Container Updates
     Date: Wed, 23 Dec 2015 08:28:34 -0800

Hash Algorithms and Performance

Tag the thread discussing SHA-256 vs. SHA-512 benchmarks, in case the
verification discussion gets back to that level of detail (I hope it
doesn't ;).  The resolution for that thread was that SHA-512 is still
faster [1].

[1]: Message-ID: <CAFi6z1Eb4K0eppRq1rG08jOfniq2RfognSuczeQfo2TNxu06Kg@mail.gmail.com>

OCI Bundle Digests Summary

Tag the fourth verification thread, marking the third thread as
obsolete.

Separate config entries for device mknod and cgroups

I filed a PR to keep this separate [1], but it was closed after [2]
landed.  See also [3], where I point out that putting the mknod stuff
in the “control groups” section is awkward.

[1]: https://github.com/opencontainers/specs/pull/99
     Add linux.resources.devices
[2]: https://github.com/opencontainers/specs/pull/94
     Replace Linux.Device with more specific config
[3]: https://github.com/opencontainers/specs/pull/171#discussion_r41190655
     move the description of user ns mapping and default files to proper file

Documenting container lifecycles

Initial work landed in [1], but it doesn't get into the order of the
setup process or explain how pause/resume/signalling work [2].  If we
don't figure these things out ahead of time, I expect we'll have to
figure them out in order to land compliance testing.

[1]: https://github.com/opencontainers/specs/pull/231
[2]: https://github.com/opencontainers/specs/pull/231/files#r46735313

Recording style and policy in opencontainers/specs

Tag this thread for documenting existing decisions to avoid rehashing
settled issues in the absence of new arguments.  See also [1].

[1]: https://github.com/opencontainers/specs/issues/273

Versioning specs in the face of ambiguity

Tag the thread about how we intend to version the spec.  See
additional version discussion in [1,2,3,4,5].

[1]: Subject: Re: Initial Draft Release
     Date: Fri, 11 Sep 2015 13:58:08 -0700
     Message-ID: <20150911205808.GC5912@odin.tremily.us>
[2]: https://github.com/opencontainers/specs/issues/183
     New v0.1.1 tag doesn't match v0.1.0 in version.go
[3]: https://github.com/opencontainers/specs/pull/253
     Clarify backwards compatibility for major version 0
[4]: https://github.com/opencontainers/specs/pull/194
     Correct version from 0.1.0 to 0.1.1
[5]: https://github.com/opencontainers/specs/pull/278
     Project: document release process

Hashing and verifying a bundle

Tag the third verification thread, marking the second thread as
obsolete.

distributable and decentralized values

Tag the second distribution thread, marking the old thread as
obsolete.

appc + oci harmonization progress

Tag the initial distribution-disussing thread.

Dropping the rootfs requirement and restoring arbitrary bundle content

Tag this thread, which allows for bundles that don't pivot-root, and
allows bundle authors to distribute additional content.  However, the
root filesystem requirement is enshrined in the adopted charter [1,2],
so the 'charter' tag flags it for TOB action once we get a TOB.

[1]: https://www.opencontainers.org/governance
[2]: Message-ID: <20150826195447.GX21585@odin.tremily.us>

Specifying the runtime's command-line interface

Tag this thread, which adds a feature (basic usability) for runtime
callers.  There is implementation work in [1], but no formal
references to that from opencontainers/specs until we pick up
sufficient runtime mass.

[1]: https://github.com/wking/oci-command-line-api

Start a new nmbug repository