Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
423 commits
Select commit Hold shift + click to select a range
b0996ba
image-layout.md: references can contain digits
runcom Jun 15, 2016
790e2d3
image-layout.md: include example of a manifests list
runcom Jun 15, 2016
346ca18
image-layout.md: refs can contain descriptors to both a manifest and …
runcom Jun 15, 2016
8b56619
Merge pull request #137 from runcom/regexp-ref
vbatts Jun 15, 2016
fe63795
image-layout: clarify refs can be generic
vbatts Jun 15, 2016
3723ab6
serialization: add language about whiteout
Jun 15, 2016
1149fac
manifest: use descriptor doc as canonical source
Jun 15, 2016
e94aa35
schema: add a docker v2.2 backwards compat test
Jun 16, 2016
453673d
*: Fix '&lt' -> '<' and '&gt' -> '>' typos
wking Jun 16, 2016
97ba05f
Merge pull request #146 from wking/fix-broken-comparison-entities
jonboulle Jun 16, 2016
e2bbe92
Merge pull request #141 from philips/whiteout-language
jonboulle Jun 16, 2016
d67f1e5
media-types.md: fix typo
runcom Jun 16, 2016
5c0ce84
Merge pull request #149 from runcom/typo-1
philips Jun 16, 2016
3f29dae
Merge pull request #139 from vbatts/clarify_refs
jonboulle Jun 16, 2016
656697a
Merge pull request #143 from philips/remove-external-doc-dependency
vbatts Jun 16, 2016
2a0bfdc
Merge pull request #145 from philips/add-compat-test
vbatts Jun 17, 2016
4e3789d
descriptor: size int64
runcom Jun 16, 2016
8427ef1
manifest: explain schemaVersion == 2
runcom Jun 17, 2016
7c10f51
schema: fix json formatting
runcom Jun 17, 2016
16879e9
Makefile: fix fmt target and format json files
jonboulle Jun 17, 2016
3490642
schema: close files
runcom Jun 17, 2016
67893d5
serialization: add explanation of DiffIDs
Jun 15, 2016
22951a0
Merge pull request #157 from runcom/c-f
jonboulle Jun 17, 2016
6f76343
test: exercise manifest list backwards compat
runcom Jun 17, 2016
5ca671c
Merge pull request #155 from runcom/schema-version-lang
jonboulle Jun 17, 2016
1059b10
schema: update from updated esc command
runcom Jun 18, 2016
bcc115e
Merge pull request #158 from jonboulle/master
philips Jun 20, 2016
c3ad3c7
Merge pull request #160 from runcom/esc-new-version
jonboulle Jun 20, 2016
82b42b6
Merge pull request #154 from runcom/mlist
vbatts Jun 20, 2016
e0afe63
serialization: add test, make volumes null
Jun 16, 2016
d365b79
serialization: Entrypoint and Cmd nullable
runcom Jun 16, 2016
7871606
Merge pull request #152 from runcom/validation
vbatts Jun 21, 2016
b36f351
Merge pull request #142 from philips/layers-and-diffids
stevvooe Jun 22, 2016
fab787e
glide: introduce glide.yaml
Jun 16, 2016
ecb2556
Makefile: implemented update-deps target, add hacking guide
Jun 16, 2016
a664feb
glide: vendor dependencies
Jun 23, 2016
ca58cdf
Merge pull request #148 from s-urbaniak/vendor
vbatts Jun 27, 2016
593b8f0
proposals: add release-approval-process
Jun 9, 2016
889639a
proposal: release-approval-process add some motivation
Jun 10, 2016
7e11601
proposals: release approval process to one week for apps
Jun 14, 2016
e48c6c7
proposals: release approval process 3 rcs required
Jun 14, 2016
445ee2d
proposals: release approval process: one month pre-releases
Jun 14, 2016
f629094
proposals: release approval process: use consistent language for rejects
Jun 14, 2016
c15c0e2
proposals: release approval process: clarify utility of GitHub
Jun 14, 2016
3fd90e8
proposals: release-approval-process: add voting members language
Jun 14, 2016
267f916
proposals: release approval process: add quorum language
Jun 15, 2016
eecc4fe
proposals: release approval process: add language about mailing list
Jun 15, 2016
f2148b6
proposals: release approval process: add information to projects
Jun 15, 2016
89afeeb
proposals: release approval process: improve REJECT feedback
Jun 15, 2016
775db84
proposals: release-approval-process: fixup additional typos
Jun 16, 2016
40966cf
release-approval: Shuffle to make more DRY
wking Jun 16, 2016
c340e73
release-approval: Add non-spec unanimous quorum reduction
wking Jun 17, 2016
af1013d
proposals: release-approval-process fix a grammar thing
Jun 22, 2016
be10456
proposal: fix a typo
Jun 22, 2016
86b3087
proposals: release approval process explain security@ email
Jun 25, 2016
bcffc06
manifest: Punt mediaType, size, and digest to descriptor docs
wking Jul 2, 2016
56629bb
manifest: Remove a tab-indent for "Subsequent layers..."
wking Jul 2, 2016
6c04600
Add a working call-in number
Jul 7, 2016
d767e00
Merge pull request #170 from duglin/phone
stevvooe Jul 8, 2016
ce633c1
Makefile: comments and simplify
vbatts Jun 27, 2016
c732cc2
project-governance: Make voting more generic
wking Jun 25, 2016
56abe12
GOVERNANCE and RELEASES: split the files
Jun 29, 2016
16f0fee
specs-go: add version types
runcom Jun 16, 2016
4267a18
specs-go: add v1 types
runcom Jun 16, 2016
274680c
Merge pull request #166 from vbatts/update-deps
vbatts Jul 19, 2016
45e8036
Merge pull request #172 from runcom/export-types
vbatts Jul 21, 2016
52dbb39
Merge pull request #15 from philips/add-governance-and-releases-docs
caniszczyk Jul 21, 2016
0e8f74b
cmd/oci-image-tool: replace colon with hyphen to get blobs by digest
runcom Jul 22, 2016
116950e
cmd/oci-image-tool: fix config.json generation
runcom Jul 22, 2016
6541392
cmd/oci-image-tool: error out if path destination does not exist
runcom Jul 22, 2016
44210d0
cmd/oci-image-tool: fix unpacking...
runcom Jul 22, 2016
08bed93
.tool/lint: bump gocyclo req
runcom Jul 22, 2016
cf5a7fc
glide: add github.com/russross/blackfriday
s-urbaniak Jul 22, 2016
9a93f84
glide: vendor new dependencies
s-urbaniak Jul 22, 2016
e60ff1d
cmd/oci-image-tool: add manuals
runcom Jul 22, 2016
05c6752
Add governance and release process
caniszczyk Jul 22, 2016
e3a1166
Merge pull request #167 from wking/manifest-doc-lean-on-descriptor
stevvooe Jul 22, 2016
704359b
Merge pull request #181 from s-urbaniak/fixvendor
vbatts Jul 23, 2016
ffa6f7f
Makefile: add helpers for glide-vc and !glide installed
runcom Jul 22, 2016
2682d99
Merge pull request #178 from runcom/fix-makefile-vendor-test
vbatts Jul 25, 2016
57bfc8f
Merge pull request #183 from caniszczyk/add-gov-release-docs
philips Jul 27, 2016
64513b0
Merge pull request #180 from runcom/add-readme
vbatts Jul 27, 2016
bb9ce34
PullApprove has support to check for DCO reqs
caniszczyk Jul 28, 2016
0bac884
Merge pull request #177 from runcom/fix-oci-image-tool
philips Jul 29, 2016
e3eddc9
Fix link in descriptor.md
coolljt0725 Aug 1, 2016
a52d250
Update weekly call time
glestaris Aug 1, 2016
5c30f95
Merge pull request #187 from coolljt0725/fix_link
vbatts Aug 1, 2016
febedec
Merge pull request #188 from glestaris/patch-1
philips Aug 3, 2016
bda75f2
Merge pull request #153 from runcom/size-int64
vbatts Aug 3, 2016
15b0b26
Merge pull request #184 from caniszczyk/add-dco-pullapprove-support
philips Aug 3, 2016
ebd6015
Typo: remove duplicate given
coolljt0725 Aug 4, 2016
5573cfa
image: reduce permissions on mkdir
vbatts Aug 1, 2016
a7449fe
Merge pull request #189 from vbatts/reduce_dir_perms
jonboulle Aug 9, 2016
0285172
Merge pull request #192 from coolljt0725/fix_typos
vbatts Aug 9, 2016
52b9aec
Typo: use entrypoint instead of entry point
coolljt0725 Aug 8, 2016
397efbe
Fix typo in man page for oci-image-tool
amitsaha Aug 9, 2016
bb5cc35
serialization: describe the roll of opaque whiteout files
stevvooe Jul 7, 2016
eb869cc
Merge pull request #194 from amitsaha/man-typo
jonboulle Aug 10, 2016
18a84a9
Merge pull request #191 from coolljt0725/fix_typo
jonboulle Aug 10, 2016
2bae0dc
Merge pull request #171 from stevvooe/opaque-whiteout
vbatts Aug 10, 2016
7431439
ChangeLog: add the v0.4.0 release notes
Aug 10, 2016
d400f10
Typo: fix typo in descriptor.go
coolljt0725 Aug 11, 2016
ca97691
Merge pull request #197 from coolljt0725/fix_typo_in_descriptor
vbatts Aug 11, 2016
8045bdd
oci-image-tool: add README
vbatts Aug 11, 2016
85d1eeb
Merge pull request #198 from vbatts/add_README
vbatts Aug 12, 2016
3ec97bf
Merge pull request #195 from philips/0.4.0-changelog
philips Aug 17, 2016
949159d
Makefile: Clarify OUTPUT_DIRNAME variable
Aug 15, 2016
d0db3b4
Makefile: use 'command' instead of 'which' to locate docker
Aug 19, 2016
751df36
Makefile: Add support for building with native pandoc
Aug 19, 2016
e6e9e4a
Makefile: Error if neither pandoc nor docker installed
Aug 20, 2016
b8a105c
correct example in bundle man
Aug 22, 2016
c11398c
correct blob digest set
Aug 22, 2016
38fbdd4
improve walk function on returning result
Aug 23, 2016
f61c50d
[ReadMe] Update example to v0.4.0
RobDolinMS Aug 23, 2016
978e989
Merge pull request #200 from xiekeyang/runc
philips Aug 24, 2016
b3e7910
Merge pull request #199 from xiekeyang/master
philips Aug 24, 2016
7cb2899
Merge pull request #202 from RobDolinMS/patch-1
vbatts Aug 24, 2016
06eff3e
Merge pull request #131 from grahamwhaley/native_pandoc
philips Aug 24, 2016
f74f0f7
manifest: remove carry-over cruft
vbatts Aug 24, 2016
71650f2
spec: split serialization into image and layer
stevvooe Aug 24, 2016
b76270e
[ReadMe] Adds boilerplate MUST, MAY, etc. language
RobDolinMS Aug 24, 2016
3dfdd76
Merge pull request #205 from vbatts/remove_cruft
jonboulle Aug 24, 2016
09fc80c
Merge pull request #207 from RobDolinMS/patch-2
vbatts Aug 24, 2016
0c52d5d
serialization: remove windows-specific layers+base rootfs
stevvooe Aug 26, 2016
522c065
typo: fix a url
Aug 27, 2016
42b36b8
remove redundant code
Aug 29, 2016
c290842
Merge pull request #206 from stevvooe/split-serialization
jonboulle Aug 30, 2016
bc8c68b
Merge pull request #211 from stevvooe/remove-windows-specific
jonboulle Aug 30, 2016
6e6d327
Merge pull request #217 from x1022as/redudant-code
jonboulle Aug 30, 2016
48e5f03
serialization: Drop "Tag" and "Repository" terms
wking Aug 30, 2016
6a9e9d3
Merge pull request #201 from xiekeyang/refactor
vbatts Aug 31, 2016
79d0c7f
image-layout: add explanation of the refs directory use case for tags
Aug 31, 2016
66556df
Merge pull request #215 from xiekeyang/typo
jonboulle Aug 31, 2016
d1918d2
oci-image-tool.1: Fix "oci-image-tools" -> "oci-image-tool" typos
wking Aug 31, 2016
04fea6c
bugfix: walk function exit incorrectly
Aug 31, 2016
dc8d653
Merge pull request #229 from xiekeyang/bugfix
vbatts Aug 31, 2016
fe00fbf
Merge pull request #223 from wking/tk/drop-repo-terms
philips Aug 31, 2016
4b41db2
Merge pull request #225 from philips/add-tags-notes
stevvooe Aug 31, 2016
259eb6b
Merge pull request #228 from wking/oci-image-tools-typos
jonboulle Aug 31, 2016
95fcfd0
image-layout: use slash separated hierarchy for blob storage
stevvooe Aug 31, 2016
5861fdb
serialization: remove extra "hierarchy" from mediatypes
stevvooe Aug 26, 2016
6170597
Merge pull request #212 from stevvooe/remove-serialization-from-media…
stevvooe Sep 1, 2016
29650c8
image: slash separation between algo and hash
runcom Aug 31, 2016
b1fef6d
Merge pull request #232 from stevvooe/use-slash-hierarchy-for-blobs
jonboulle Sep 1, 2016
4b1152b
Fix link in image-layout.md
coolljt0725 Sep 1, 2016
f0c82c1
Typo: fix a typo in layer.md
coolljt0725 Sep 1, 2016
bc6a287
Merge pull request #230 from runcom/colon-to-slash
philips Sep 1, 2016
d1014a4
Merge pull request #239 from coolljt0725/fix_typo
jonboulle Sep 1, 2016
aa32af6
image: error out on duplicate tar entry
runcom Sep 1, 2016
08ef0b1
Merge pull request #240 from runcom/fix-196
vbatts Sep 1, 2016
fa7d941
[ReadMe] Remove extraneous "should"
RobDolinMS Sep 1, 2016
e7ba619
[Media Types] Update graphic to remove combined
RobDolinMS Sep 1, 2016
50ceec0
[Media-types.png] Delete old image
RobDolinMS Sep 1, 2016
ad1c7fb
[Media-types.png] Replace with updated image
RobDolinMS Sep 1, 2016
1ec6417
cmd/oci-image-tool/man: clarify unpack and create-runtime-bundle desc…
runcom Sep 1, 2016
f31a452
Merge pull request #236 from coolljt0725/fix_link_descriptor
jonboulle Sep 2, 2016
d9b45db
Merge pull request #245 from RobDolinMS/patch-1
jonboulle Sep 2, 2016
bbe1d76
Merge pull request #241 from runcom/fix-man
jonboulle Sep 2, 2016
7cb680d
Merge pull request #249 from RobDolinMS/patch-3
stevvooe Sep 2, 2016
b8ff53a
serialization: Remove "changeset" from terminology
wking Sep 1, 2016
2f6d7fd
serialization: Restore old union/layer note for layer entry
wking Sep 2, 2016
faa00a7
Merge pull request #243 from wking/changeset-clarification
stevvooe Sep 2, 2016
f29d8bc
GOVERNANCE.md: fix typo
runcom Sep 3, 2016
6fb87b7
typo fix
xiekeyang Sep 4, 2016
9b4e469
GOVERNANCE.md: fix typo
runcom Sep 4, 2016
55691e3
Merge pull request #253 from xiekeyang/typo
vbatts Sep 4, 2016
00257db
Fix link to layer.md
coolljt0725 Sep 5, 2016
6d5ee08
Makefile: add -cover to go test
runcom Sep 6, 2016
d667b35
Makefile: exclude vendor/ from go test
runcom Sep 6, 2016
0a7ee3f
typo fix
Sep 6, 2016
6ca74be
cmd/oci-image-tool: support multiple --ref
runcom Sep 6, 2016
70ba7b2
Merge pull request #264 from xiekeyang/typo
vbatts Sep 6, 2016
2d41df0
Merge pull request #263 from runcom/tests
vbatts Sep 6, 2016
9d2ca48
Merge pull request #258 from coolljt0725/fix_link_serlization.md
vbatts Sep 6, 2016
d81a903
Merge pull request #17 from runcom/fix-typo
crosbymichael Sep 6, 2016
f36d5c5
Merge pull request #252 from runcom/gov-typo
jonboulle Sep 6, 2016
4f6b5fd
Merge pull request #265 from runcom/multi-ref
vbatts Sep 6, 2016
bedfc7e
specs-go/v1: rename to mediatype layer and config
runcom Sep 6, 2016
ca9bb8e
*: use types from specs-go/
runcom Sep 6, 2016
551f37d
specs-go/v1: fix Entrypoint
runcom Sep 6, 2016
4829143
cmd/oci-image-tool: validate descriptors MediaType
runcom Sep 6, 2016
23567b1
descriptor: revamp for readability
jonboulle Sep 6, 2016
f3a8be2
Merge pull request #267 from jonboulle/master
vbatts Sep 6, 2016
2c3b6ee
cmd/oci-image-tool/man: Document multiple --ref for 'validate'
wking Sep 7, 2016
a832e3c
Fix unpack multiple layers
coolljt0725 Sep 7, 2016
9b22e26
Merge pull request #274 from coolljt0725/fix_unpack
jonboulle Sep 7, 2016
d3cfb99
Merge pull request #269 from wking/man-validate-multiple-refs
jonboulle Sep 7, 2016
24c10ea
adds some description re: compat with docker schemas
mikebrow Sep 6, 2016
9a93cca
Merge pull request #262 from runcom/fixies
vbatts Sep 7, 2016
3f4c120
Makefile: add missing document pages
vbatts Sep 7, 2016
364b09a
layer: add introductory comments
Aug 31, 2016
38c4544
remove temporary directory for unit test with TestUnpackLayerDuplicat…
Sep 7, 2016
5c9e424
Fix media type on unpacking layer
coolljt0725 Sep 8, 2016
0a76d61
Add license head to manifest_test.go
coolljt0725 Sep 8, 2016
1948a30
serialization: Require 'layers' for rootfs.type
wking Sep 8, 2016
f5a91ff
layer: revamp for readability
vbatts Sep 2, 2016
64e7a30
descriptor: add urls property
runcom Aug 24, 2016
0cf32b8
Merge pull request #275 from vbatts/add_files_to_docs
stevvooe Sep 8, 2016
cddf362
Merge pull request #255 from vbatts/clarify_tar_entry_order
vbatts Sep 8, 2016
e6a431f
Merge pull request #277 from wking/solidify-serialization-rootfs-type
stevvooe Sep 8, 2016
378f472
layer: add use of "entries" for "files" in tar
vbatts Sep 8, 2016
3f2490d
panic fix
Sep 1, 2016
85bbf42
improper error description
Sep 8, 2016
6304f58
README: Fix "can then discovered" -> "can then be discovered"
Sep 9, 2016
6a13509
Merge pull request #238 from xiekeyang/fixpanic
jonboulle Sep 9, 2016
a480306
cmd/oci-image-tool: validate all refs by default
runcom Sep 8, 2016
75a51ed
fix regular expression of algorithim
Aug 30, 2016
f548b84
Merge pull request #268 from mikebrow/add-links-to-compatibility-matrix
jonboulle Sep 9, 2016
72d0525
Merge pull request #282 from vbatts/layer_tweaks
jonboulle Sep 9, 2016
5a0447a
Merge pull request #169 from runcom/layer-urls
stevvooe Sep 9, 2016
8a0c75c
layers: describe policy enforcement for foreign layer media type
stevvooe Sep 1, 2016
d5fd2d8
media-type: clarify that we have MIME-compatible media types
stevvooe Sep 9, 2016
c2b9e7f
media-types: break up sentence into multiple lines
stevvooe Sep 9, 2016
e48e595
layer: change to "non-distributable" over foreign
stevvooe Sep 9, 2016
5553ed5
Merge pull request #221 from x1022as/descriptor
stevvooe Sep 9, 2016
873b9b6
Add some text about extensions
Jun 26, 2016
d564f8e
Merge pull request #284 from TrumanLing/fix-typo
stevvooe Sep 9, 2016
660d130
descriptor: Require lowercase hex
wking Sep 9, 2016
67f771c
Fixes small typo
kushaldas Sep 12, 2016
104ecd1
adaptive format character in html block
Sep 12, 2016
ec62652
Merge pull request #291 from stevvooe/break-sentence
jonboulle Sep 12, 2016
8c2642e
Merge pull request #290 from stevvooe/better-wording-to-introduce-med…
jonboulle Sep 12, 2016
61989fe
Merge pull request #278 from xiekeyang/error-value
jonboulle Sep 12, 2016
34f012e
specs-go/v1: add nondistributable media type
runcom Sep 12, 2016
8d0ee71
Merge pull request #257 from coolljt0725/fix_media_type
vbatts Sep 12, 2016
f964286
Merge pull request #295 from kushaldas/typofix
vbatts Sep 12, 2016
2396f87
README: Update links after layer.md split
wking Sep 9, 2016
4aa74ac
Merge pull request #292 from wking/lowecase-hex
stevvooe Sep 12, 2016
dd6522f
Use changeset instead of change set
coolljt0725 Sep 13, 2016
ddc89f2
Merge pull request #164 from duglin/extensions
philips Sep 13, 2016
2903142
Merge pull request #233 from stevvooe/foreign-layer-media-type
philips Sep 13, 2016
c2ed5aa
Merge pull request #279 from runcom/validate-all-refs
philips Sep 13, 2016
6a6219d
Merge pull request #294 from xiekeyang/typo
philips Sep 13, 2016
b1d6969
Merge pull request #297 from runcom/nondistributable-mt
philips Sep 13, 2016
cd16bf2
Merge pull request #285 from wking/readme-layer-link
jonboulle Sep 13, 2016
a375252
image: fix typo in docstring
jonboulle Sep 13, 2016
93290f9
image: undo overzealous docstring wrapping
jonboulle Sep 13, 2016
32fe0ab
Typo: remove comma in example json of volume
coolljt0725 Sep 13, 2016
bfd9879
img: update media-types image
runcom Sep 13, 2016
3795c5f
schema: fix manifest test
runcom Sep 13, 2016
fd84d6a
Merge pull request #298 from coolljt0725/changeset
vbatts Sep 13, 2016
24092d9
Merge pull request #302 from coolljt0725/fix_example
vbatts Sep 13, 2016
e566f16
Merge pull request #270 from TrumanLing/master
vbatts Sep 13, 2016
90334bd
Merge pull request #303 from runcom/fix-297
vbatts Sep 13, 2016
7e6e2f7
Merge pull request #300 from jonboulle/master
vbatts Sep 13, 2016
17c1f00
*: rename serialization.md -> config.md
vbatts Sep 13, 2016
55a3d9e
Merge pull request #305 from vbatts/rename
stevvooe Sep 14, 2016
02e1ecd
Merge remote-tracking branch 'origin/master'
runcom Sep 15, 2016
b5b3f3c
Merge remote-tracking branch 'pt/master'
runcom Sep 15, 2016
fe363aa
*: move to opencontainers/image-tools
runcom Sep 15, 2016
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 3 additions & 24 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,24 +1,3 @@
# Compiled Object files, Static and Dynamic libs (Shared Objects)
*.o
*.a
*.so

# Folders
_obj
_test

# Architecture specific extensions/prefixes
*.[568vq]
[568vq].out

*.cgo1.go
*.cgo2.c
_cgo_defun.c
_cgo_gotypes.go
_cgo_export.*

_testmain.go

*.exe
*.test
*.prof
/oci-create-runtime-bundle
/oci-unpack
/oci-image-validate
14 changes: 14 additions & 0 deletions .header
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
// Copyright 2016 The Linux Foundation
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

11 changes: 11 additions & 0 deletions .pullapprove.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
approve_by_comment: true
approve_regex: '^(Approved|lgtm|LGTM|:shipit:|:star:|:\+1:|:ship:)'
reject_regex: ^Rejected
reset_on_push: true
signed_off_by:
required: true
reviewers:
teams:
- image-spec-maintainers
name: default
required: 2
13 changes: 13 additions & 0 deletions .tool/check-license
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
#!/usr/bin/env bash

set -o errexit
set -o nounset
set -o pipefail

ret=0

for file in $(find . -type f -iname '*.go' ! -path './vendor/*'); do
(head -n3 "${file}" | grep -Eq "(Copyright|generated|GENERATED)") || (echo "${file}:missing license header" && ret=1)
done

exit $ret
25 changes: 25 additions & 0 deletions .tool/lint
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
#!/usr/bin/env bash

set -o errexit
set -o nounset
set -o pipefail

if [ ! $(command -v gometalinter) ]; then
go get -u github.com/alecthomas/gometalinter
gometalinter --update --install
fi

for d in $(find . -type d -not -iwholename '*.git*' -a -not -iname '.tool' -a -not -iwholename '*vendor*'); do
gometalinter \
--exclude='error return value not checked.*(Close|Log|Print).*\(errcheck\)$' \
--exclude='.*_test\.go:.*error return value not checked.*\(errcheck\)$' \
--exclude='duplicate of.*_test.go.*\(dupl\)$' \
--exclude='schema/fs.go' \
--exclude='duplicate of.*main.go.*\(dupl\)$' \
--disable=aligncheck \
--disable=gotype \
--disable=gas \
--cyclo-over=35 \
--tests \
--deadline=10s "${d}"
done
24 changes: 24 additions & 0 deletions .travis.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
language: go
go:
- 1.6
- 1.7

sudo: required

before_script:
- export PATH=$HOME/gopath/bin:$PATH

before_install:
- make install.tools
- go get -u github.com/alecthomas/gometalinter
- gometalinter --install --update
- go get -t -d ./...

install: true

script:
- make .gitvalidation
- make lint
- make check-license
- make test
- make tools
119 changes: 119 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,119 @@
## Contribution Guidelines

### Pull requests are always welcome

We are always thrilled to receive pull requests, and do our best to
process them as fast as possible. Not sure if that typo is worth a pull
request? Do it! We will appreciate it.

If your pull request is not accepted on the first try, don't be
discouraged! If there's a problem with the implementation, hopefully you
received feedback on what to improve.

We're trying very hard to keep the project lean and focused. We don't want it
to do everything for everybody. This means that we might decide against
incorporating a new feature.


### Conventions

Fork the repo and make changes on your fork in a feature branch:

- If it's a bugfix branch, name it XXX-something where XXX is the number of the
issue
- If it's a feature branch, create an enhancement issue to announce your
intentions, and name it XXX-something where XXX is the number of the issue.

Small changes or changes that have been discussed on the project mailing list
may be submitted without a leader issue, in which case you are free to name
your branch however you like.

If the project has a test suite, submit unit tests for your changes. Take a
look at existing tests for inspiration. Run the full test suite on your branch
before submitting a pull request.

Update the documentation when creating or modifying features. Test
your documentation changes for clarity, concision, and correctness, as
well as a clean documentation build. See ``docs/README.md`` for more
information on building the docs and how docs get released.

Write clean code. Universally formatted code promotes ease of writing, reading,
and maintenance. Always run `gofmt -s -w file.go` on each changed file before
committing your changes. Most editors have plugins that do this automatically.

Pull requests descriptions should be as clear as possible and include a
reference to all the issues that they address.

Commit messages must start with a capitalized and short summary
written in the imperative, followed by an optional, more detailed
explanatory text which is separated from the summary by an empty line.

Code review comments may be added to your pull request. Discuss, then make the
suggested modifications and push additional commits to your feature branch. Be
sure to post a comment after pushing. The new commits will show up in the pull
request automatically, but the reviewers will not be notified unless you
comment.

Before the pull request is merged, make sure that you squash your commits into
logical units of work using `git rebase -i` and `git push -f`. After every
commit the test suite (if any) should be passing. Include documentation changes
in the same commit so that a revert would remove all traces of the feature or
fix.

Commits that fix or close an issue should include a reference like `Closes #XXX`
or `Fixes #XXX`, which will automatically close the issue when merged.

### Sign your work

The sign-off is a simple line at the end of the explanation for the
patch, which certifies that you wrote it or otherwise have the right to
pass it on as an open-source patch. The rules are pretty simple: if you
can certify the below (from
[developercertificate.org](http://developercertificate.org/)):

```
Developer Certificate of Origin
Version 1.1

Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
660 York Street, Suite 102,
San Francisco, CA 94110 USA

Everyone is permitted to copy and distribute verbatim copies of this
license document, but changing it is not allowed.


Developer's Certificate of Origin 1.1

By making a contribution to this project, I certify that:

(a) The contribution was created in whole or in part by me and I
have the right to submit it under the open source license
indicated in the file; or

(b) The contribution is based upon previous work that, to the best
of my knowledge, is covered under an appropriate open source
license and I have the right under that license to submit that
work with modifications, whether created in whole or in part
by me, under the same open source license (unless I am
permitted to submit under a different license), as indicated
in the file; or

(c) The contribution was provided directly to me by some other
person who certified (a), (b) or (c) and I have not modified
it.

(d) I understand and agree that this project and the contribution
are public and that a record of the contribution (including all
personal information I submit with it, including my sign-off) is
maintained indefinitely and may be redistributed consistent with
this project or the open source license(s) involved.
```

then you just add a line to every git commit message:

Signed-off-by: Joe Smith <[email protected]>

using your real name (sorry, no pseudonyms or anonymous contributions.)

You can add the sign off when creating the git commit via `git commit -s`.
70 changes: 70 additions & 0 deletions GOVERNANCE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
# Project governance

The [OCI charter][charter] §5.b.viii tasks an OCI Project's maintainers (listed in the repository's MAINTAINERS file and sometimes referred to as "the TDC", [§5.e][charter]) with:

> Creating, maintaining and enforcing governance guidelines for the TDC, approved by the maintainers, and which shall be posted visibly for the TDC.

This section describes generic rules and procedures for fulfilling that mandate.

## Proposing a motion

A maintainer SHOULD propose a motion on the [email protected] mailing list (except [security issues](#security-issues)) with another maintainer as a co-sponsor.

## Voting

Voting on a proposed motion SHOULD happen on the [email protected] mailing list (except [security issues](#security-issues)) with maintainers posting LGTM or REJECT.
Maintainers MAY also explicitly not vote by posting ABSTAIN (which is useful to revert a previous vote).
Maintainers MAY post multiple times (e.g. as they revise their position based on feeback), but only their final post counts in the tally.
A proposed motion is adopted if two-thirds of votes cast, a quorum having voted, are in favor of the release.

Voting SHOULD remain open for a week to collect feedback from the wider community and allow the maintainers to digest the proposed motion.
Under exceptional conditions (e.g. non-major security fix releases) proposals which reach quorum with unanimous support MAY be adopted earlier.

A maintainer MAY choose to reply with REJECT.
A maintainer posting a REJECT MUST include a list of concerns or links to written documentation for those concerns (e.g. GitHub issues or mailing-list threads).
The maintainers SHOULD try to resolve the concerns and wait for the rejecting maintainer to change their opinion to LGTM.
However, a motion MAY be adopted with REJECTs, as outlined in the previous paragraphs.

## Quorum

A quorum is established when at least two-thirds of maintainers have voted.

For projects that are not specifications, a [motion to release](#release-approval) MAY be adopted if the tally is at least three LGTMs and no REJECTs, even if three votes does not meet the usual two-thirds quorum.

## Security issues

Motions with sensitive security implications MUST be proposed on the [email protected] mailing list instead of [email protected], but should otherwise follow the standard [proposal](#proposing-a-motion) process.
The [email protected] mailing list includes all members of the TOB.
The TOB will contact the project maintainers and provide a channel for discussing and voting on the motion, but voting will otherwise follow the standard [voting](#voting) and [quorum](#quorum) rules.
The TOB and project maintainers will work together to notify affected parties before making an adopted motion public.

## Amendments

The [project governance](#project-governance) rules and procedures MAY be amended or replaced using the procedures themselves.
The MAINTAINERS of this project governance document is the total set of MAINTAINERS from all Open Containers projects (runC, runtime-spec, and image-spec).

## Subject templates

Maintainers are busy and get lots of email.
To make project proposals recognizable, proposed motions SHOULD use the following subject templates.

### Proposing a motion

> [{project} VOTE]: {motion description} (closes {end of voting window})

For example:

> [runtime-spec VOTE]: Tag 0647920 as 1.0.0-rc (closes 2016-06-03 20:00 UTC)

### Tallying results

After voting closes, a maintainer SHOULD post a tally to the motion thread with a subject template like:

> [{project} {status}]: {motion description} (+{LGTMs} -{REJECTs} #{ABSTAINs})

Where `{status}` is either `adopted` or `rejected`.
For example:

> [runtime-spec adopted]: Tag 0647920 as 1.0.0-rc (+6 -0 #3)

[charter]: https://www.opencontainers.org/about/governance
7 changes: 7 additions & 0 deletions MAINTAINERS
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
Brandon Philips <[email protected]> (@philips)
Brendan Burns <[email protected]> (@brendandburns)
Jason Bouzane <[email protected]> (@jbouzane)
John Starks <[email protected]> (@jstarks)
Jonathan Boulle <[email protected]> (@jonboulle)
Stephen Day <[email protected]> (@stevvooe)
Vincent Batts <[email protected]> (@vbatts)
Loading