Create generic library generation template for inclusion with APIs

Description

Following from work in uis/devops/iam/activate-account/api#23 (closed), we should move the written template for releasing client library jobs into a generic CI template for other repositories to make use of.

Further details

This job does not build the schema, it should accept a schema file either as a build artefact from an upstream job or from a location within the repository that is running the job.

Task list

Acceptance criteria

• CI template exists, matching functionality from uis/devops/iam/activate-account/api#23 (closed)
• CI template usage is documented in the guidebook
• Book in a show and tell entry

Links/references

added issuetypeTask teamIdentity workflowNeeds Refinement labels

added to epic uis/devops&205

marked this issue as blocked by uis/devops/iam/activate-account/api#23 (closed)

changed the description

marked this issue as blocking uis/devops/iam/activate-account/api#22 (closed)

changed the description

added time estimate of 1d 4h

added workflowSprint Ready label and removed workflowNeeds Refinement label

mentioned in epic uis/devops&205

assigned to @rjw57

changed iteration to IAM Sprint Nov 20, 2024 - Dec 3, 2024

marked this issue as blocked by #94 (closed)

I've added #94 (closed) as a blocker since we ultimately want the OpenAPI generation in the common CI pipeline and, if it is going to integrate with release-it, we therefore need release-it in there too.

It's a "soft" blocker in that we could work around it by conditionally including a release-it-specific template but it'd be nicer all around to integrate release-it.

In my mind, we need a consistent way to version artefacts and the only one we have is our release-it tooling. Therefore, it should be in common pipeline

Is the plan here then to review current open MRs for this issue, but not close this until #94 (closed) is complete as well and any follow on is done in this MR as necessary?

FWIW, #94 (closed) should be complete but, what with uis/devops/iam/activate-account/api#30 (closed) not likely to be solved imminently I suppose #94 (closed) is no-longer a blocker because we've kicked release-it integration to the side for the moment.

I'll remove #94 (closed) as a blocker but it should be reviewable as is and "complete" once the MR associated with it is merged.

Ok, yep makes sense, will try and get to that MR as well then!

mentioned in merge request uis/devops/iam/activate-account/api!66 (merged)

removed iteration IAM Sprint Nov 20, 2024 - Dec 3, 2024

changed iteration to IAM Sprint Dec 4, 2024 - Dec 17, 2024

added workflowIn Progress label and removed workflowSprint Ready label

changed the description

mentioned in commit 25b46e28

mentioned in merge request !110 (merged)

changed the description

mentioned in commit uis/devops/docs/guidebook@330312b2

mentioned in merge request uis/devops/docs/guidebook!403 (merged)

changed the description

added quick to review workflowReview Required labels and removed workflowIn Progress label

added workflowUnder Review label and removed workflowReview Required label

removed the relation with #94 (closed)

mentioned in commit uis/devops/docs/guidebook@aaa853d8

closed with merge request uis/devops/docs/guidebook!403 (merged)

mentioned in commit uis/devops/iam/activate-account/api@a77a205b

mentioned in merge request uis/devops/iam/activate-account/api!68 (merged)

mentioned in commit uis/devops/iam/activate-account/api@b1fb6eae

mentioned in merge request uis/devops/iam/activate-account/api!67 (merged)