Release Management announcements

Owned by Tanja de Groot
Last updated: Oct 10, 2024
5 min read

This page is to prepare the messages for the announcement of milestones or other events from the release management team.

Spring25

2024-10-09: Spring25 meta-release: M0 announcement (all@lists.camaraproject.org)

We are pleased to announce that the TSC has declared the kick-off (M0) of the Spring25 meta-release in their October 3rd meeting.

ย The meta-release plan can be found here: Meta-release Spring25.

ย For M1 (Oct 31st), the Commonalities and Identity & Consent Management teams are working hard on their scope definitions:

  • The set of related PRs are under preparation: critical PRs will be available by Oct 15th and other PRs by Oct 31st.

  • Exceptionally, no pre-releases will be available yet for M1, so Sub-Project teams are asked to review and comment the PRs and start taking them into account as of M1.

ย For questions or comments, please use the GitHub issues, the FAQ or email theย wg-release-management@lists.camaraproject.org.

ย All teams off to Spring25 ๐Ÿ˜Š

The CAMARA Release Management team

Fall24

2024-07-19: M3 milestone - new date: 2024-07-26 & preparation hints (to rm mailing list)

Dear all,

In the light of the upcomingย M3 milestone, please find the following point to get prepared:

  • ย 

    the TSC has shifted the M3 date toย 2024-07-26, but earlier is very welcome

  • at this date it is sufficient to have the release PR for the API release-candidate.

    • please put the link to the release PR in the (pre)-release tag field on the API release tracker when your PR is ready for review

  • in this release PR you need to include:

    • any updates to the readme.md as needed

    • the update of theย changelog.md file

      • see example here:ย ReleaseManagement/documentation/CHANGELOG_EXAMPLE.md

      • HINT: create a "draft release" with GitHub to see the relevant changes since the previous version and select relevant PRs, reformulate as needed and sort them into the categories of the changelog.

    • the update of the yaml file with the concerned API version and URL

      • A reminder that the API version (x-y-z-rc.1) is different from the release number of the pre-release (which will be r1.1).ย ย 

    • the update of theย API readiness checklist with all required content for the release-candidate

    • exceptionally, although the checklist mandates to provide the basic test cases with the release-candidate, for this first meta-release, the Sub Projects are allowed to delay these to M4. However the earlier the test cases are provided, the longer the time to actuall test any available API implementation. Please use the comment field in the checklist to indicate the delay if any. M3 will not be blocked on this point.

  • do not use release branches anymore: all releases are to happen using the GitHub release feature from the main branch and setting release tags on the main branch. If this is an issue for M3, this can be resolved for M4.ย 

  • please notify the Release Management team to review the PR by adding https://github.com/orgs/camaraproject/teams/release-management_maintainers as reviewers to the release PR.ย 

Other HINTS: (see API guidelines section 11.1)

ย 

  • check that your servers object in the yaml looks as follows:

servers:

ย  - url: '{apiRoot}/yourapiname/v0.yrc1 orย v1rc1'

ย ย ย  variables:

ย ย ย ย ย  apiRoot:

ย ย ย ย ย ย ย  default: http://localhost:9091

ย ย ย ย ย ย ย  description: API root, defined by the service provider, e.g. `api.example.com` or `api.example.com/somepath`

ย 

  • add the following in the yaml in the info object: x-camara-commonalities: 0.4.0

example:

info:

ย  title: One Time Password SMS

ย  description: |-

ย ย ย  Service Enabling Network Function API to send short-lived OTPs (one time passwords) to a phone number via SMS and validate it afterwards, in order to verify the phone number as a proof of possession.

ย 

ย ย ย  # Relevantย  Definitions and concepts

ย ย ย  - **NaaS**: *Network-as-a-Service* model where Telco Network resources are exposed to third parties through APIs. In this particular API, One Time Password is exposed following this model.

ย ย ย  - **OTP**: *One Time password* is a one-time authorization code (OTAC) that is valid for only one login session or transaction.

ย 

ย ย ย  # API Functionality

ย ย ย  It enables a Service Provider (SP) to send an OTP code by SMS and validate it to verify the phone number (MSISDN) as a proof of possession.

ย 

ย ย ย  # Resources and Operations overview

ย ย ย  This API currently provides two endpoints, one to send an OTP to a given phone number and another to validate the code received as input.

ย 

ย ย ย  # Authorization and authentication

ย ย ย  [Camara Security and Interoperability Profile](https://github.com/camaraproject/IdentityAndConsentManagement/blob/main/documentation/CAMARA-Security-Interoperability.md) provides details on how a client requests an access token.

ย 

ย ย ย  Which specific authorization flows are to be used will be determined during onboarding process, happening between the API Client and the Telco Operator exposing the API, taking into account the declared purpose for accessing the API, while also being subject to the prevailing legal framework dictated by local legislation.

ย 

ย ย ย  It is important to remark that in cases where personal user data is processed by the API, and users can exercise their rights through mechanisms such as opt-in and/or opt-out, the use of 3-legged access tokens becomes mandatory. This measure ensures that the API remains in strict compliance with user privacy preferences and regulatory obligations, upholding the principles of transparency and user-centric data control.

ย 

ย  version: 1.0.0-rc.1

ย  x-camara-commonalities: 0.4.0

ย  termsOfService: http://example.com/terms/

ย  contact:

ย ย ย  name: API Support

ย ย ย  url: http://www.example.com/support

ย ย ย  email: support@example.com

ย  license:

ย ย ย  name: Apache 2.0

ย ย ย  url: https://www.apache.org/licenses/LICENSE-2.0.html

ย 

ย 

For more examples please see OTPvalidation and QualityOnDemand Sub Projects

Questions or comments ? create aย Release Mgmt issue, mail the RM mailing list or look at the FAQ.

The links to the latter 2, and more generally on the API release process, are on the RM wiki and in GitHub.

Thanks !

The CAMARA Release Management team

ย 

2024-07-04: Meta-release M2: release PRs for Commonalities and Identity and Consent Management (tsc@lists.camaraproject.org)

Dear TSC members,

Dear TSC members

Please review the following 2 release PRs in preparation of the M2 milestone:

Thanks !

The CAMARA Release Management team

ย 

2024-07-04: Fall24 meta-release: M0 and pre-M1/M2 announcement (all@lists.camaraproject.org)

This email is to announce

  • the M0 (kick-off) of the Fall24 meta-release which was approved by the TSC on April 18th

  • the pre-M1/M2 announcement for Commonalities and Identity and Consent Management (ICM)

Fall24 Commonalities & Identity and Consent Management

The meta-release can be found here:ย Meta-release Fall24.

All interested API Sub Projects are asked to prepare their release-candidate(s) API versions for the M3 of the Fall24 meta-release.

To do this please

  • create theย API release trackerย for the API version(s) planned for the Fall24 meta-release (see the wiki page for more info)

  • subscribe your API contacts to theย wg-release-management@lists.camaraproject.org for further announcements

  • start the activities described for the API Sub Projects here:ย Meta-release Process

  • develop the API(s) and check alignment with the Commonalities and ICM scope issue / release PR

  • announce API progress on the API's release tracker each time an API version (with its release assets according to the checklist) is madeย available

For questions or comments, please use the GitHub issues, the FAQ or email theย wg-release-management@lists.camaraproject.org

Have fun for Fall24ย ย 

The Release Management team

ย