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

Create an Artifacts Working Group #368

Closed
scottrigby opened this issue Apr 5, 2023 · 12 comments · Fixed by #409
Closed

Create an Artifacts Working Group #368

scottrigby opened this issue Apr 5, 2023 · 12 comments · Fixed by #409
Labels
tag-discuss Items to be reviewed at the next TAG general meeting. toc-review CNCF TOC has requested this review. wg-artifacts

Comments

@scottrigby
Copy link
Contributor

Hello, everyone!

There is serious interest in a new Artifacts Working Group. We are asking to create this WG under TAG App Delivery, as outlined in this WG Artifacts Charter draft.

Please create the WG under TAG App Delivery. Thank you!

Brief history

There has been an ongoing effort to improve support for OCI artifacts for Cloud Native app delivery. Recently a group of interested parties has begun work on improving artifacts search and discovery. This Artifacts Search and Discovery goal, however, relates to wider artifact improvement within the cloud native ecosystem, and so it is now outlined as one of several activities for a new Artifacts Working Group. Such a WG belongs within CNCF, and under TAG App Delivery, as outlined in this WG Artifacts Charter draft.

@developer-guy
Copy link

This is super cool 🫠 I'd love to be part of that WG ☝️💯

@dlorenc
Copy link

dlorenc commented Apr 5, 2023

It would be helpful to understand where the work output from here is intended to land (CNCF vs. OCI). In my experience there's been a lot of confusion already around things like OCI Artifacts, so being clear up front on what the deliverables from this group are and where they're intended to live would be useful.

A few questions:

  • Will these be extensions to the OCI APIs that live in a CNCF project?
  • Will recommendations from here end up being proposed over to the OCI and going through their standard process?

I see that the draft charter calls out some of this and says:

The group is in CNCF rather than OCI because OCI's TOB determined that work on Artifacts other than container images should be in CNCF while OCI focuses on container images exclusively [3].
[2]: https://github.com/cncf/toc/blob/main/tags/app-delivery.md#areas-considered-in-scope
[3]: opencontainers/tob#68

But I'm not sure I interpret that closed TOB issue the same way. Either way, it's several years old, so checking back in with the OCI TOB to get their current thoughts would still be useful. Lots of movement has happened in this space recently there.

@imjasonh
Copy link

imjasonh commented Apr 5, 2023

As noted in a comment on the WG charter doc:

I'd like to suggest this clarify the goal as being an OCI extension specified by this WG, and not for these common formats to be defined in OCI itself.

To be more explicit: whatever the group produces, whether it's new APIs, new types, a system for extensible type registration, whatever, I believe it should be limited to text defined and controlled by some CNCF body, perhaps using the OCI extensions mechanism, and not a proposal for new OCI specs itself.

If the goal is OCI specs, you need to engage with the OCI TOB, not CNCF TAG App Delivery.

Going that route means this group should be very careful about positioning the work as "an artifacts API defined by CNCF TAG App Delivery" and not anything that could be confused to mean "the OCI artifacts API". Positioning it as an official OCI thing would require approval from OCI TOB and an OCI WG process. We've been less careful about our words in the past, and it's caused no end of confusion.

@scottrigby
Copy link
Contributor Author

scottrigby commented Apr 5, 2023

Thanks @imjasonh 👍 Yes, confirmed. The discussion so far has been precisely this. Perhaps using OCI extensions, and not to create update the OCI spec itself. Any such improvement would, of course, have to be a collaboration with – and move through – the OCI org and its existing processes.

The goal of moving this work to CNCF came from previous discussion on this with OCI org members through past work on artifacts, and there has already been some informal discussion between several folks currently involved in OCI now. I will join tomorrow's OCI meeting, and make sure we're all on the same page. (Thanks @amye for pointing out that meeting!). I have added an item to that meeting's agenda.

Also, I hope we can connect in person in Amsterdam, since I just found out there will be an OCI event at KubeCon! Looking forward to moving ahead with this in the best way(s) possible ❤️

@scottrigby
Copy link
Contributor Author

@dlorenc just to follow up on your comment too

A few questions:

  • Will these be extensions to the OCI APIs that live in a CNCF project?

The proposed WG would be a vendor-neutral and transparent place to discuss and explore these ideas. However, any implementation would live in the correct locations. For example, code will likely live in an ORAS subproject. Yes so far extensions have been the proposed path forward.

  • Will recommendations from here end up being proposed over to the OCI and going through their standard process?

But - continuing from above - yes if there ends up being recommendations to propose for the OCI spec, this will absolutely move through OCI orgs existing processes, no question.

I see that the draft charter calls out some of this and says:

The group is in CNCF rather than OCI because OCI's TOB determined that work on Artifacts other than container images should be in CNCF while OCI focuses on container images exclusively [3].
[2]: https://github.com/cncf/toc/blob/main/tags/app-delivery.md#areas-considered-in-scope
[3]: opencontainers/tob#68

But I'm not sure I interpret that closed TOB issue the same way. Either way, it's several years old, so checking back in with the OCI TOB to get their current thoughts would still be useful. Lots of movement has happened in this space recently there.

The fact that some time has passed is a good point. However, a number of the members of this proposed working group have spent a lot of time going that route in the past. But yes, per my comment to @imjasonh above I will join tomorrow's OCI meeting and we can make sure we're all on the space page about every part of this proposal. The most important thing is to have a neutral, fair, and transparent place to move ahead with improvements to artifacts that a number of projects are interested in. We will do the right thing, either way, and may have to discuss the goals a bit more to clarify any ambiguity 💖

@vbatts
Copy link

vbatts commented Apr 5, 2023

I'm glad to see this tighter coupling.

There will be an OCI meeting at KubeCon, that some of us will be attending (including myself).
Date: Wednesday, April 19
Time: 2:30pm - 5:00pm
Room: D203-204

@dlorenc
Copy link

dlorenc commented Apr 5, 2023

The fact that some time has passed is a good point. However, a number of the members of this proposed working group have spent a lot of time going that route in the past.

Thanks! This is really the only part I take objection to. I don't believe the OCI TOB ever issued a statement "that work on Artifacts other than container images should be in CNCF while OCI focuses on container images exclusively". I don't think they said that two years ago, and I don't think they'd agree with that statement today.

I also don't think it really matters - the OCI is a different group than the CNCF and this TAG and can't claim to "own" or "block" anyone from doing work like this, but I do think it's important to be accurate in this framing.

@sabre1041
Copy link
Collaborator

I'm glad to see this tighter coupling.

There will be an OCI meeting at KubeCon, that some of us will be attending (including myself). Date: Wednesday, April 19 Time: 2:30pm - 5:00pm Room: D203-204

Excellent. I'll be attending and look to participate in the OCI meeting

It will be good to get some mindshare across communities

@angellk
Copy link
Contributor

angellk commented Apr 5, 2023

I may be late but plan to attend as well on April 19. Agree, having a tighter coupling across communities would be excellent.

@joshgav joshgav added toc-review CNCF TOC has requested this review. tag-discuss Items to be reviewed at the next TAG general meeting. labels May 3, 2023
@joshgav
Copy link
Contributor

joshgav commented May 18, 2023

TAG App Delivery will host an initial meeting for the Artifacts WG tomorrow Friday May 19 to finish the charter and start work towards goals. Here are the details!

@joshgav
Copy link
Contributor

joshgav commented Jun 2, 2023

Update for folks following: we held the meeting described in the previous comment a couple weeks ago and then another one today; and we're ready to submit a PR with the proposed charter for the group based on the contents of the draft doc above the horizontal line. The draft charter, meeting notes, and meeting recording playlist are linked below.

@afflom will work on getting the PR for the charter to this repo following the existing conventions in the TAG for gitops-wg and platforms-wg. Once he does that @joshgav (I) will open an issue in cncf/toc to get their review and approval of the PR, similar to cncf/toc#1034. Merging the PR will close this issue and represent the inauguration of the official WG!

I'll put this on the agenda for the next TAG meeting too to be sure all are aware and give feedback.

For ongoing discussions join the #wg-artifacts Slack channel!

afflom added a commit to afflom/tag-app-delivery that referenced this issue Jun 5, 2023
Establish the Artifacts WG under CNCF TAG App Delivery.

Refs: cncf#368
afflom added a commit to afflom/tag-app-delivery that referenced this issue Jun 6, 2023
Establish the Artifacts WG under CNCF TAG App Delivery.

Refs: cncf#368
Signed-off-by: Alex Flom <[email protected]>
@ktarplee
Copy link

I would love to be a part of the artifacts working group regardless of if it lands in CNCF or OCI.

afflom added a commit to afflom/tag-app-delivery that referenced this issue Jun 16, 2023
Establish the Artifacts WG under CNCF TAG App Delivery.

Refs: cncf#368
Signed-off-by: Alex Flom <[email protected]>
afflom added a commit to afflom/tag-app-delivery that referenced this issue Jun 16, 2023
Establish the Artifacts WG under CNCF TAG App Delivery.

Refs: cncf#368
Signed-off-by: Alex Flom <[email protected]>
afflom added a commit to afflom/tag-app-delivery that referenced this issue Jun 16, 2023
Establish the Artifacts WG under CNCF TAG App Delivery.

Refs: cncf#368
Signed-off-by: Alex Flom <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
tag-discuss Items to be reviewed at the next TAG general meeting. toc-review CNCF TOC has requested this review. wg-artifacts
Projects
None yet
Development

Successfully merging a pull request may close this issue.

9 participants