Commit Graph

376 Commits

Author SHA1 Message Date
W. Trevor King d715acfc1e style: Document recent Go-pointer exceptions
The general rule seems to be:

  If Go's default value has the same semantics we'd use for an unset
  value, don't bother with a pointer.

I'm not sure how well that squares with [1]:

  We want a consistent way to identify unset settings.

But if the falsy values count as "unset", maybe the "null is a
consistent identifier for unset" approach was never really viable.

Qiang points out that pointers are required to opt-out of boolean
settings where both true and false would require action [2], so I've
worded the exception to only apply when the Go default for the type is
expicitly a no-op in the spec.

I'm also not sure if the new style extends to integers where zero has
the same semantics as unset values.  It sounds like Michael was ok
with no pointers for those values [3], but OOMScoreAdj (where zero
clearly means "do nothing") got a pointer in #233 [4].  More clarity
on the threshold would be nice; in this commit I've laid out the logic
and not explicitly listed the types it applies to.

[1]: https://github.com/opencontainers/specs/pull/233#discussion_r47829711
[2]: https://github.com/opencontainers/specs/pull/317/files#r50932706
[3]: https://github.com/opencontainers/specs/pull/233#issuecomment-155250592
[4]: https://github.com/opencontainers/specs/pull/233/files#diff-34c30be66233f08b447fb608ea0e66bbR206

Signed-off-by: W. Trevor King <wking@tremily.us>
2016-01-26 21:23:49 -08:00
Michael Crosby a7b50925d8 Merge pull request #314 from mrunalp/update_go_version
Update the go version to 1.5.3
2016-01-21 13:51:03 -08:00
Mrunal Patel ca1b5727b4 Update the go version to 1.5.3
Signed-off-by: Mrunal Patel <mrunalp@gmail.com>
2016-01-21 15:30:41 -05:00
Vincent Batts acc1c63752 Merge pull request #290 from mrunalp/no_new_priv
Add NoNewPrivileges setting for linux
2016-01-20 17:45:55 -05:00
Mrunal Patel 5f327ba339 Add NoNewPrivileges setting for linux
This is a security setting that could be used to prevent processes in the
container from gaining additional privileges.

Signed-off-by: Mrunal Patel <mrunalp@gmail.com>
2016-01-20 14:30:29 -05:00
Vincent Batts c8de60be8a Merge pull request #295 from vbatts/vbatts-test
Makefile: add a target to run tests
2016-01-20 13:41:02 -05:00
Vish Kannan 72e7cf9daf Merge pull request #280 from philips/try-and-add-some-use-cases
README: add some user stories
2016-01-19 12:57:00 -08:00
Brandon Philips 9289afe113 README: add runtime, bundle, and hook author user
Lets call out some users directly and give them titles. Then define what
they is trying to do.

Signed-off-by: Brandon Philips <brandon.philips@coreos.com>
2016-01-19 12:23:42 -08:00
Qiang Huang ec7ca919b7 Merge pull request #309 from vbatts/version_name
config: qualify the name of the version field
2016-01-18 12:07:51 +08:00
Mrunal Patel ed08c12e1a Merge pull request #312 from duglin/AbsCWD
Make cwd an abs path to avoid ambiguity
2016-01-15 16:02:54 -08:00
Vincent Batts 4e63ee0a1e config: qualify the name of the version field
https://github.com/opencontainers/specs/issues/110

Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2016-01-15 10:51:53 -05:00
Doug Davis 5fb3203f6d Make cwd an abs path to avoid abiguity
Signed-off-by: Doug Davis <dug@us.ibm.com>
2016-01-15 06:10:21 -08:00
Mrunal Patel d61af700d4 Merge pull request #311 from vbatts/unicode
style: remove unicode character
2016-01-14 16:12:31 -08:00
Vincent Batts 0e904c904f style: remove unicode character
pandoc/LaTeX is not happy with this shady character.

```
! Package inputenc Error: Unicode char \u8:↔ not set up for use with
LaTeX.
```

Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2016-01-14 15:18:52 -05:00
Vincent Batts 0cd1ca4d1d Makefile: git-validation from an arbitrary epoch
Since we can't go from the first commit, choosing an arbitrary epoch commit

Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2016-01-14 10:31:40 -05:00
Vincent Batts 70e725cedd Makefile: add a target to run tests
For now, just vet and lint. But would like to include the commit
validator, once a good range is selectable.

Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2016-01-13 18:54:58 -05:00
Mrunal Patel 52cbf479f2 Merge pull request #308 from vbatts/more-cwd
config: corresponding change for required field
2016-01-13 14:30:57 -08:00
Vincent Batts 111e69668b config: corresponding change for required field
Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2016-01-13 17:18:39 -05:00
Vincent Batts 353631ab5e Merge pull request #253 from hqhq/hq_version_compat
Clarify backwards compatibility for major version 0
2016-01-13 16:46:02 -05:00
Mrunal Patel d2617a1203 Merge pull request #307 from vbatts/carry-cwd
Clarify cwd
2016-01-13 13:42:46 -08:00
Vincent Batts 1f519091e2 Merge pull request #304 from mrunalp/clarify_rootfs
Remove clarify rootfs item from the ROADMAP
2016-01-13 16:42:23 -05:00
Mrunal Patel b28481ae37 Merge pull request #301 from vbatts/roadmap-distribution.md
ROADMAP: adding distribution format line item
2016-01-13 13:41:30 -08:00
Mrunal Patel 18edc801d2 Merge pull request #306 from vbatts/roadmap-protobuf
ROADMAP: remove the protobuf line item
2016-01-13 13:38:33 -08:00
Vincent Batts 25e6674a4c config: cwd is a required default
After thorough discussion, even though a reasonable default is "/", for
platform independence, leave this up to the bundle author.

Also, by this variable being present it makes things explicit for the
runtime.

Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2016-01-13 16:32:23 -05:00
Vincent Batts 2d6ef2325d ROADMAP: remove the protobuf line item
As using protobuf has been decided against, this removes it from the
Roadmap items.

Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2016-01-13 15:04:40 -05:00
Mrunal Patel c6d40b514e Remove clarify rootfs item from the ROADMAP
We discussed this in the face to face meeting and agreed
that it makes sense to keep the rootfs as is for flexibility.

Signed-off-by: Mrunal Patel <mrunalp@gmail.com>
2016-01-13 11:55:00 -08:00
Michael Crosby ad6092e1b2 Merge pull request #296 from wking/integer-classID
runtime-config-linux: Convert classID from hex to uint32
2016-01-13 11:54:45 -08:00
Vincent Batts 4715448f7d ROADMAP: adding distribution format line item
Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2016-01-13 14:41:50 -05:00
Vincent Batts 588d54b350 Merge pull request #300 from duglin/patch-1
Update ROADMAP.md
2016-01-13 14:30:03 -05:00
Doug Davis 0fe5798279 Update ROADMAP.md
Signed-off-by: Doug Davis <dug@us.ibm.com>
2016-01-13 11:20:41 -08:00
Mrunal Patel 837f67d46b Merge pull request #294 from vbatts/bumpversion_v0.3.0
Bumpversion v0.3.0
2016-01-12 15:58:48 -08:00
W. Trevor King 5a960a478d runtime-config-linux: Convert classID from hex to uint32
The just-landed style conventions prefer integers to hex strings [1],
and I said I'd post an update for this setting if/when those landed
[2].  The kernel uses uint32s for this setting [3].

[1]: https://github.com/opencontainers/specs/pull/287
[2]: https://github.com/opencontainers/specs/pull/287#discussion_r48899312
[3]: https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/include/net/cls_cgroup.h?id=refs/tags/v4.3#n24

Signed-off-by: W. Trevor King <wking@tremily.us>
2016-01-08 10:56:14 -08:00
Mrunal Patel 6aa53edc9b Merge pull request #287 from wking/policy
style: Collect established conventions in a discoverable location
2016-01-08 10:12:27 -08:00
Vincent Batts bd8131216e version: bump v0.3.0-dev
Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2016-01-07 10:24:10 -05:00
Vincent Batts 467fd17d4f version: introduce a string for dev indication
Include a changelog of commit subjects

Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2016-01-07 10:23:36 -05:00
Vish Kannan 6a6ba67755 Merge pull request #292 from vbatts/tiesheng_oomscoreadj
runtime-config-linux: Add info to clarify oom_score_adj (carrying #236)
2016-01-06 06:20:32 -08:00
W. Trevor King 408412ba80 style: Collect established styles in a discoverable location
So we have something to cite to avoid rehashing established decisions.
Provide some motivation and links to the backing discussion so folks
can re-open these if they have new information that wasn't covered in
the original decision.

Like the glossary (18734986, glossary: Provide a quick overview of
important terms, 2015-08-11, #107), I've used subsection titles for
each entry to get link anchors.

Signed-off-by: W. Trevor King <wking@tremily.us>
2016-01-05 13:31:29 -08:00
Vincent Batts 011acdfc73 runtime-config: defer description to linux docs
Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2016-01-05 15:49:11 -05:00
Qiang Huang dd17705087 Merge pull request #291 from Ephemera/patch-1
Fix typo in Filesystem Bundle
2016-01-05 16:18:11 +08:00
Ephemera 7a94673f42 Fix typo in Filesystem Bundle
Signed-off-by: GyuYong Jung <obliviscence+git@gmail.com>
2016-01-05 16:02:30 +09:00
Qiang Huang 4916d73709 Merge pull request #171 from gao-feng/update-runtime-config-linux-md
move the description of user ns mapping and default files to proper file
2016-01-05 14:53:50 +08:00
Gao feng 053f05933b move the description of user ns mapping to proper file
They should stay in runtime not config.

Signed-off-by: Gao feng <omarapazanadi@gmail.com>
2016-01-05 14:19:45 +08:00
Gao feng 0c9a97890d runtime-config: add example label before json exmaple
Signed-off-by: Gao feng <omarapazanadi@gmail.com>
2016-01-05 14:13:38 +08:00
Mrunal Patel 4060e6c1cc Merge pull request #288 from wking/glossary-doc-files
Makefile: Add glossary to DOC_FILES
2016-01-04 10:28:07 -08:00
Michael Crosby 99ef7393a3 Merge pull request #289 from vbatts/fixup_vishh
MAINTAINERS: correct Vish's github account
2016-01-04 10:05:08 -08:00
Vincent Batts 3c294d5752 Merge pull request #283 from jonboulle/master
Appropriately mark optional fields as omitempty
2016-01-04 12:48:23 -05:00
Vincent Batts 433abe0b98 Merge pull request #279 from hqhq/hq_fix_swappiness_value
Fix value of swappiness
2016-01-04 10:55:36 -05:00
Vincent Batts 575ad87ef4 MAINTAINERS: correct Vish's github account
Reported-by: W. Trevor King <wking@tremily.us>
Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2016-01-04 10:12:25 -05:00
Jonathan Boulle 986fc9831e Mark RootfsPropagation as omitempty
Signed-off-by: Jonathan Boulle <jonathanboulle@gmail.com>
2015-12-31 12:16:27 +01:00
W. Trevor King d7acd86e0e Makefile: Add glossary to DOC_FILES
At the end of the list, to match its position in the README.  This
catches #107 up with #263, which I'd missed during one of the #107
rebases.

Signed-off-by: W. Trevor King <wking@tremily.us>
2015-12-29 20:45:53 -08:00