ORAS Community Meeting (bi-weekly)

tags: oras

Zoom Call Info

  • Meeting time:
    • Tuesday 5-6pm pacific time, 8-9pm US Eastern, 8-9am Shanghai (US Summer time)
    • Tuesday 4-5pm pacific time, 8-9pm US Eastern, 8~9 Shanghai (US Winter time)
  • Zoom Dial-in link

Template

  • Copy template from the bottom - Template
  • Ensure agenda items have an owner

Mar 5, 2025

Attendees:

  • Andrew Block
  • Feynman Zhou
  • Shiwei Zhang
  • Sajay Antony
  • Sylvia Lei
  • Xiaoxuan Wang
  • Yi Zha

Agenda Items:

Notes:

Recording: https://youtu.be/3HYgugHD0fQ

Feb 18, 2025

Attendees

  • Andrew Block
  • Feynman Zhou
  • Shiwei Zhang
  • Sylvia Lei
  • Yi Zha
  • Flavio Schuindt
  • Patrick Pan
  • Terry Howe

Agenda

Meeting notes

  • CNCF is owning the domain oras.land. @sabre1041 will help Valentine to create a service ticket to request CNCF's help on getting the group id for the domain https://github.com/oras-project/oras-java/pull/100
  • Based on the community discussion on Feb 18, ORAS maintainers agreed on these things:
    • Show root image and its all referrers in the JSON output by default. This ensures data consistency among other data format output (e.g. tree, table)
    • Use referrers as the field name in the top-level and second-level referrers, instead of manifests
    • Show the referrers with full depth by default, introduce a flag --depth to allow users to limit the maximum depth of referrers in the formatted output.
    • ORAS will not introduce an additional flag to limit the number of referrers now since there is no clear performace concern so far. ORAS can provide the automatic timeout mechanism to users in case too many referrers with a root image.
    • Use JSON Schema and text to list the fields in formatted output
  • Feynman will inform Terry to restrucure his spec https://github.com/oras-project/oras/pull/1610 once the enhancement proposal template is merged
  • The following PRs and GitHub issues requires maintainers to review asynchronously:

Feb 11, 2025

Attendees

  • Feynman Zhou
  • Shiwei Zhang
  • Sajay Antony
  • Sylvia Lei
  • Terry Howe
  • Xiaoxuan Wang
  • Nora Hu
  • Flavio
  • Patrick Pan

Agenda

Notes

Jan 21, 2025

Attendees

  • Feynman Zhou
  • Shiwei Zhang
  • Sajay Antony
  • Sylvia Lei
  • Terry Howe
  • Xiaoxuan Wang
  • Yi Zha

Agenda

Notes

Jan 7, 2025

Attendees

  • Feynman Zhou
  • Shiwei Zhang
  • Sajay Antony
  • Sylvia Lei
  • Billy Zha
  • Terry Howe
  • Xiaoxuan Wang

Agenda

Notes

Dec 10, 2024

Attendees

  • Feynman Zhou
  • Shiwei Zhang
  • Sajay Antony
  • Sylvia Lei
  • Billy Zha
  • Terry Howe
  • Xiaoxuan Wang

Agenda

Notes

  • Feynman will work with Terry to publish the documentation and blog post for the v1.3.0-beta.1 release
  • Jeremy Rickard shared the scenario of attach supply chain artifacts (e.g. SBOM, Vulnerability report, attestation) to multi-arch image. Feynman will document it in the spec and figure out whether this could be supported in beta.2. There is a related issue to track https://github.com/oras-project/oras/issues/1531
  • The ORAS v1.3.0-beta.2 is planned for releasing in Jan, 2025

Nov 26, 2024

Attendees

  • Feynman Zhou
  • Shiwei Zhang
  • Sajay Antony
  • Sylvia Lei
  • Billy Zha
  • Terry Howe
  • Xiaoxuan Wang

Agenda

Notes

  • Feynman shared the proposal that Andrew Block submitted to KubeCon EU. Feynman will also apply for lightning talk and booth for ORAS by Dec 3, 2024
  • ORAS maintainers aligned that there will be two beta releases before v1.3.0. These issues has been moved to v1.3.0-Beta.1 and its ETA will be December 6, 2024.
  • Feynmnan suggested ORAS maintainers continue the discussion on these two issues:
  • ORAS maintainers triaged the issues of ORAS dotnet SDK v0.3.0. Patrick Pan will provide a timeline for v0.3.0 milestone

Nov 19, 2024

Attendees

  • Andrew Block
  • Feynman Zhou
  • Shiwei Zhang
  • Sajay Antony
  • Sylvia Lei
  • Billy Zha
  • Terry Howe

Agenda

Notes

  • Andrew mentioned that he will follow up on the Argo CD integration with Blake and provide updates to ORAS maintainers next week. Andrew also shared that he will submit a proposal for ORAS to KubeCon EU
  • ORAS maintainers agreed to use an annotation-based approach to add platform information to platform-specific artifact. This will be a part of v1.4.0 milestone. The next step is to create an issue and define customized ORAS annotations.
  • Feynman will split the Multi-arch image management with ORAS into 3 issues/PRs.

Oct 29, 2024

Attendees

  • Feynman Zhou
  • Xiaoxuan Wang
  • Shiwei Zhang
  • Sajay Antony
  • Sylvia Lei
  • Billy Zha
  • Yi Zha
  • Terry Howe

Agenda items

Notes

  • Terry will send a PR to document how to generate CLI help reference doc automatically
  • ORAS maintainers agreed to promote the approach 1 annotation-based approach to add platform information. Sylvia will raise a GitHub issue to OCI image spec community
  • Feynman will schedule a meeting with Valentin (proposal author) to transfer the ORAS Java SDK repo

Oct 15, 2024

Attendees

  • Feynman Zhou
  • Xiaoxuan Wang
  • Shiwei Zhang
  • Sajay Antony
  • Sylvia Lei
  • Billy Zha
  • Yi Zha
  • Terry Howe
  • Toddy Mladenov

Agenda Items

Notes

Sep 26, 2024

Attendees:

  • Andrew Block
  • Feynman Zhou
  • Xiaoxuan Wang
  • Shiwei Zhang
  • Sajay Antony
  • Sylvia Lei
  • Billy Zha
  • Yi Zha

Agenda Items

Notes

  • ORAS maintainers agreed to enable a stale bot for the oras-go repo. Sylvia will raise a PR to implement it.
  • ORAS maintainers to ask the author of ORAS Java SDK proposal to elaborate more on the roadmap.
  • Feynman will continue to resolve comments in docs: Improve ORAS diagnose experience
  • Multi-arch image management has not been started in the meeting discussion due to the limited time

Sep 3, 2024

Attendees:

  • Feynman Zhou
  • Xiaoxuan Wang
  • Shiwei Zhang
  • Sylvia Lei
  • Andrew Block
  • Billy Zha
  • Sajay Antony
  • Toddy Mladenov

Agenda Items

Notes

We discussed these questions regarding the PR docs: Improve ORAS diagnose experience and reached consensus as follows:

  • Q: For the diagnose flag options, is it much more straightforward and less breaking if we only deprecate --verbose and remain --debug as it is?
    • ORAS maintainers agreed to deprecate --verbose and remain --debug as a unified control of debug logs. The original output of --verbose will be reserved in several oras commands pull/push/attach/discover by introducing an additional flag. The major reason is that the --debug option is more consistent with the other popular client tools and also to avoid overloading --verbose
  • Q: Is it a common practice to use an environment variable like export ORAS_DEBUG=1 as a global switch for debug logs? What are the Pros and Cons of using this design?
    • ORAS maintainers agreed to not introduce an additional environment variable as a global switch to enable debug logs since --debug is intuitive enough.
  • Q: Is it much more reasonable to output the user's environment details in oras version rather than in debug logs? The details about the environment where the tool is running, such as OS version and architecture, tool version, and environment variables (excluding sensitive data) would be super helpful to help ORAS developers and users to diagnose an issue.
    • ORAS maintainers agreed to add OS/Arch to the default output of oras version. It is hard to capture the distribution name and version, and they are not always available.
  • Q: In addiotion to DEBUG level logs generated in the --debug, should ORAS applies other log levels like INFO, ERROR, WARNING to differentiate the debug log information?
    • No. At least for the next release, there will not be other log level in ORAS debug logs. The consensus here is to only output DEBUG level logs in --debug.

Recording: Video recording is published on Youtube and Zoom chat message is available here

Aug 6, 2024

Skipped due to no agenda collected from the community

July 22, 2024

Attendees:

  • Feynman Zhou
  • Yi Zha
  • Xiaoxuangwang
  • Sylvia Lei
  • Billy
  • Shiwei Zhang
  • Sajay Antony

Agenda Items

  • Info: We will run an ORAS project booth at KubeCon China from Aug 21 to Aug 22. Andrew Block submitted a proposal to ArgoCon (KubeCon EU).
  • Vote: Release ORAS-go v1.2.6: https://github.com/oras-project/oras-go/issues/796 (Sylvia)
  • Review ORAS v1.3.0 milestone and discuss ORAS v1.3.0 (alpha-beta-rc-stable) timeline (Feynman)
  • Demo: auto-generation of CLI help reference doc (Terry), tentative

Notes

  • We triaged all issues marked in ORAS v1.3.0 and identified this list as the major work items. It has been reflected in ORAS v1.3.0 milestone.
  • We skipped the Demo of auto-generation of CLI help reference doc since Terry was not able to join the meeting

July 9, 2024

We skipped this meeting since no topics collected and several ORAS maintainers are on vacation.

Jun 25, 2024

Attendees:

  • Feynman Zhou
  • David Wheeler
  • Yi Zha
  • Xiaoxuangwang
  • Terry Howe
  • Sylvia Lei
  • Billy
  • Shiwei Zhang
  • Sajay Antony

Agenda Items

  • Brainstorming on the scnearios of image index management support (Feynman)
  • Proposal to review the community activity metrics using LFX Insights tool (Feynman)
  • Onboarding a new sub-project oci-rust-client (Taylor & Feynman)

Notes

  • We discussed and aligned that multi-arch image management is the major scenario of image index.
  • Feynman will create a report based on the metrics provided by LFX Insights tool
  • Taylor transferred the project to ORAS org https://github.com/oras-project/rust-oci-client

Jun 11, 2024

Attendees:

  • Andrew Block
  • Billy Zha
  • Feynman Zhou
  • Terry Howe
  • Xiaoxuan Wang

Agenda Items

Notes

  • Based on the vote status, ORAS maintainers agreed to accept krustlet/oci-distribution to be a sub-project of ORAS and move it to oras-project org
  • Andrew Block will share the proposal issue of ArgoCD OCI support in the ORAS community and request ORAS maintainers to review it
  • Billy and Xiaoxuan walked through the setup-oras v1.2.0 release notes

Notes

May 28, 2024

Attendees:

  • Andrew Block
  • Billy Zha
  • Feynman Zhou
  • Shiwei Zhang
  • Sylvia Lei
  • Sajay Antony
  • Taylor Thomas
  • Terry Howe
  • Xiaoxuan Wang

Agenda Items

Notes

  • ORAS v1.2.0 stable release process could be started after the release vote PR merged into main branch
  • krustlet/oci-distribution donation proposal is now opening vote for 7 days. The vote result will be announced by next Tuesday.
  • Feynman will raise a PR to add a governance doc for new repository/sub-project onboarding process
  • ORAS maintainers agreed to accept the ORAS Artifact Explorer as a sub-project. Now we could start the repo onboarnding process
  • ORAS maintainers to review Terry's PR that supports auto-generation of CLI command manual pages https://github.com/oras-project/oras-www/pull/319
  • Terry and @sabre1041 agreed to prepare the KubeCon NA CFP by June 9. @Feynman will assist them to prepare for the draft proposal

May 15, 2024

Attendees:

  • Feynman Zhou
  • Shiwei Zhang
  • Sylvia Lei
  • Sajay Antony
  • Billy Zha
  • Terry Howe
  • Xiaoxuan Wang

Agenda Items

Notes

Apr 16, 2024

Attendees:

  • Feynman Zhou
  • Shiwei Zhang
  • Sylvia Lei
  • Sajay Antony
  • Yi Zha
  • Billy Zha
  • Andrew Block
  • ToddySM

Agenda Items

  • Review remaining items of ORAS v1.2.0 RC.1. Discuss and align ORAS v1.2.0 RC.1 release plan (@Feynman )
  • Short demo of mTLS support in ORAS v1.2.0 ( @sabre1041 )
  • ORAS artifact explorer status and response from the contributor (Feynman)
  • KubeCon China CFP collaboration ( @Feynman @sabre1041 )

Notes

  • @sabre1041 demonstrated how mTLS works in ORAS v1.2.0-rc.1 and he mentioned he will create an issue to add mTLS support for oras login
  • We agreed to collaborate on KubeCon China CFP and @sabre1041 mentioned he will be able to draft the CFP in a Google Doc first.
  • We went through the remaining issues and PRs in ORAS v1.2.0 RC.1 and we are now targeting finalize all of those issues/PRs BOW.
  • @Feynman demonstrated how ORAS artifact explorer works right now and recommended maintainers to consider accepting the ORAS artifact explorer as an ORAs sub-project. We will give more time for maintainers to try and evaluate the project value.

Mar 26, 2024

Attendees:

  • Feynman Zhou
  • Shiwei Zhang
  • Sylvia Lei
  • Sajay Antony
  • Yi Zha
  • Billy Zha
  • Andrew Block

Agenda Items:

Notes:

Recording: https://www.youtube.com/live/2iiOc8JjUOw?si=sYOv6jBWwF4L40h5

Mar 19, 2024 (deferred to Mar 26 due to KubeCon EU)

Attendees:

  • add yourself

Agenda Items:

  • Vote for the release oras-go v2.5.0
    • For OCI image-spec v1.1.0 and distribution-spec v1.1.0

Notes:

  • meeting minutes

Mar 5, 2024

Attendees:

  • Andrew Block
  • Feynman Zhou
  • Shiwei Zhang
  • Sajay Antony

Agenda:

  • Discuss and align the roadmap for ORAS v1.3.0 with ORAS maintainers (Feynman)
  • Collect ideas for KubeCon EU demos (Feynman)

Notes:

  • We had an ad-hoc discussion on ORAS v1.3.0 milestone and aligned that these parts could be potential enhancements in v1.3.0:
  • ORAS verbose log enhancements: I am working on a Spec
  • X509 Authentication with OCI registry: Andrew will own this issue
  • ORAS annotating experience enhancement: We need a Spec to define related scenarios and desired experience

Recording: https://youtube.com/live/ps5i5JPwV-4

Feb 20, 2024

Attendees:

  • Andrew Block
  • ToddySm
  • Feynman Zhou
  • Yi Zha
  • Shiwei Zhang
  • Sajay Antony

Agenda Items:

Notes:

  • Feynman will create to proposal to document the ORAS CLI changes
  • Andrew suggests that prepare a blog post for OCI Spec v1.1.0 support after ORAS upgrades to OCI Spec v1.1.0
  • Sajay suggests ORAS maintainers follow up the discussion in https://github.com/opencontainers/image-spec/pull/1171

Feb 5, 2024

Skipped due to no agenda and attendees

Jan 23, 2024

Attendees:

  • Shiwei Zhang
  • ToddySM
  • Feynman Zhou
  • Sylvia Lei
  • Yi Zha
  • Billy Zha

Agenda Items:

  • Formatted JSON output demo and collect feedback from the community (Billy)
  • ORAS dotnet SDK v0.2.0 release and next step (Shiwei)
  • Propose to do an annual retro for the ORAS community in 2023 and collect community metrics (Feynman)
  • oras-go upgraded the OCI distribution spec to v1.1.0 rc.4

Notes:

  • We discussed the formatted ORAS CLI output experience only in the meeting. Toddy left a few questions in the PR and Feynman will resolve them accordingly

Jan 9, 2024

Attendees:

  • add yourself
  • Feynman Zhou
  • Jesse Butler
  • Sydney Karimi
  • Andrew Block
  • Dr. Kyle Tarplee
  • Shiwei Zhang
  • Billy Zha
  • Sylvia Lei
  • Marcin Jastrzebski
  • Yi Zha

Agenda Items:

Notes:

  • Jesse will write a proposal in a PR to resolve issue #1228
  • Feynman proposed the ETA of ORAS v1.2.0 is Feb 6. Feynman will summarize the status updates of v1.2.0 in this proposal
  • Andrew shared the proposal of Argo CD integration with ORAS and is seeking for volunteers to contribute to its implementation
  • We will discuss the oras-dotnet progress offline

Meeting recording: https://youtu.be/sRv6ZTus5gk

Dec 5, 2023

Attendees:

  • Asmit Malakannawar
  • Feynman Zhou
  • Shiwei Zhang
  • Sylvia Lei
  • Billy Zha
  • Andrew Block

Agenda

Meeting notes

Nov 21, 2023 (Cencelled)

Attendees:

Agenda

Meeting notes

Nov 7, 2023

Attendees:

  • Shiwei Zhang
  • Sajay Antony
  • Feynman Zhou
  • Sylvia Lei
  • Terry Howe
  • Kyle Tarplee
  • Yi Zha
  • Billy Zha

Agenda Items

  • Triage recent ORAS issues and decide which milestone for each issue
  • Propose having a regular rotation mechanism for community meeting moderator

Notes

  • We agreed that create a v1.3.0 milestone. There are 4 remaining issues that ORAS maintainers will need to continue to triage offline
  • ORAS-go maintainers need to continue review two PRs from Kyle
  • Feynman will create a GitHub Discussion to start regular rotation mechanism for community meeting moderator. ORAS sub-project maintainers and org-level maintainers are welcome to pick this role

Oct 23, 2023

Attendees:

  • Shiwei Zhang
  • Sajay Antony
  • Feynman Zhou
  • Sylvia Lei
  • Terry Howe

Agenda Items:

  • Which output formats need to be considered for the scripting scenario? We have received a feature request on JSON ouput as discussed in issue #638.

Meeting notes

  • We discussed the requirements and challenges about output format for scripting scenario. @Feynman will start working on the spec based on Andy Gee's preliminary version.

Oct 10, 2023

Attendees:

  • Feynman Zhou
  • Shiwei Zhang
  • Andrew Block
  • ToddySM
  • Sylvia Lei
  • Sajay Antony
  • Billy Zha
  • Anurag
  • Yi Zha
  • add yourself

Agenda Items:

Notes:

Recording

TBD

Sep 12, 2023

Attendees:

  • Feynman Zhou
  • Billy Zha
  • Sylvia Lei
  • Shubham Singh
  • Yi Zha
  • Sajay Antony
  • add yourself

Agenda Items:

Notes:

Aug 28, 2023

Attendees:

  • Deepesha Burse
  • Shiwei Zhang
  • Feynman Zhou
  • Vasu
  • Sylvia Lei
  • Billy Zha
  • Terry Howe
  • Asmit Malakannawar
  • Yi Zha
  • Sajay Antony

Agenda items

  • Release ORAS-go v2.3.0
  • Visit ORAS CLI v1.2.0 milestone and define the scope
  • Ubuntu Snap installation issue #1079 reported by the user
  • Request review on the PR #250 raised by Sajay
  • Request ORAS maintainers to vote on the proposal of creating a repository for ORAS artifact explorer, see issue

Meeting Notes

  • ORAS maintainers to vote on the proposal of creating a repository for ORAS artifact explorer, see issue
  • Billy to investigate a workaround for the Snap installation issue #1079

Aug 15, 2023

Attendees:

  • Deepesha Burse
  • Shiwei Zhang
  • Feynman Zhou
  • Vasu
  • Sylvia Lei
  • Billy Zha
  • Terry Howe
  • Asmit Malakannawar
  • Yi Zha
  • Sajay Antony

Agenda items

Notes:

Recording

Video: https://www.youtube.com/watch?v=9Mc_ZChp4gc

Aug 1, 2023

Attendees:

  • Aman
  • Billy Zha
  • Feynman Zhou
  • Sylvia Lei
  • Sajay Antony
  • Shiwei Zhang
  • Terry Howe
  • Yi Zha

Agenda Items:

  • Ask to close issue 1011 if there is no concerns on releasing OCI 1.1.0 (Sajay)
  • Request to adjust release plan of ORAS CLI, see issue 1038 (Feynman)
  • Demo progress bar UX of ORAS CLI as requested in issue 893 (Billy)
  • Request review and for the release management doc (Feynman)
  • Automating docs for oras-cli (Aman)
  • Automate Package installation - Homebrew, Winget (Aman)
  • Digest the tagged manifest pr 1034

Notes:

Recording

TBD

July 18, 2023

Attendees:

  • Andrew Block
  • Billy Zha
  • Feynman Zhou
  • Sylvia Lei
  • Sajay Antony
  • Shiwei Zhang
  • Terry Howe
  • ToddySM
  • Yi Zha

Agenda Items:

Notes and actions:

  • Billy to create a new issue to request vote for releasing ORAS v1.1.0
  • Feynman to follow up on automating the ORAS upgrade in package manager systems issue 1025 after ORAS v1.1.0. It will not block ORAS CLI v1.1.0 release
  • Logging improvements for ORAS are planned in ORAS v1.2.0 and ORAS v2.0.0 (if the issues are breaking changes) respectively. Sajay also shared his proposal of CLI Output Guidelines for ORAS CLI https://hackmd.io/fvLyJ4NLSkKJug1JpOcsbA
  • Feynman to create an issue to request to create a new repository for ORAS Artifact Explorer project
  • ORAS v1.2.0 release ETA will be discussed in the next bi-weekly meeting

Recording

TBD

2023-01 - 2023-06

2021 - 2022

Meeting Notes Template

(template for copying)

Meeting Date

Attendees:

  • add yourself

Agenda Items:

  • add your topics

Notes:

  • meeting minutes
Select a repo