Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add CNAB_CLAIMS_VERSION and mount path for claim.json #300

Merged
merged 4 commits into from
Jan 6, 2020

Conversation

technosophos
Copy link
Member

This adds two related features:

  • $CNAB_CLAIMS_VERSION specifies (within the CNAB invocation image) what version of the claims specification is supported
  • /cnab/claim.json is the required path in the invocation image where the claim must be presented.

Signed-off-by: Matt Butcher [email protected]

400-claims.md Outdated

The invocation image may benefit from accessing the claim. Consequently, a claim MUST be attached to the invocation image when the invocation image is started.

The claim MUST be mounted at the path `/cnab/claim.json` inside of the bundle. The version of this claim that is to be mounted is the _version prior to this operation beginning_. In other words, when a bundle is installed, it creates the original installation claim. On the first upgrade, the claim describe the _installation_ is located at `/cnab/claim.json`. This allows the invocation image to inspect the former state and compare it to the desired new state.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perhaps reword the claim describe to the claim describing or the claim that describes?

400-claims.md Outdated

The claim MUST be mounted at the path `/cnab/claim.json` inside of the bundle. The version of this claim that is to be mounted is the _version prior to this operation beginning_. In other words, when a bundle is installed, it creates the original installation claim. On the first upgrade, the claim describe the _installation_ is located at `/cnab/claim.json`. This allows the invocation image to inspect the former state and compare it to the desired new state.

Note: Systems may be compliant to the core specification but not support the claims specification. If `$CNAB_CLAIMS_VERSION` is not present, a runtime SHOULD assume that the claims specification is not implemented. Bundle authors may therefore have to take care when relying upon `/cnab/claim.json`, accommodating the case where the runtime does not support claims.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: compliant with the core specification.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed per @radu-matei 's comment

technosophos and others added 3 commits January 6, 2020 12:01
Copy link
Contributor

@carolynvs carolynvs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM 🚀

@technosophos technosophos merged commit 05c30cc into cnabio:master Jan 6, 2020
@technosophos technosophos deleted the fix/296-old-claim-mounted branch January 6, 2020 21:04
Copy link

@JAME13469 JAME13469 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

jetlove3053 bff2331145

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants