[netmod] Re: Call for volunteers for CI/CD YANG Integration in martinthomson/internet-draft-template

[[e-mail]]

Hi all,

Thanks for the interest and sharing all these inputs.

FYI, we had a kick-off meeting yesterday. The introduction slides (including participants, sketch, first agreed points) can be found here: https://github.com/IETF-OPS-AD/misc/blob/main/cicd-yang-template.pdf.

This work will be hosted here: https://github.com/IETF-OPS-AD/I-D-with-yang-template. Please use that link to report issues, etc.

Cheers,
Med

De : Rob Wilton (rwilton) <[e-mail]>
Envoyé : mardi 22 avril 2025 16:38
À : Florian Kauer <[e-mail]>; BOUCADAIR Mohamed INNOV/NET <[e-mail]>; [e-mail]
Cc : Italo Busi <[e-mail]>
Objet : Re: [netmod] Re: Call for volunteers for CI/CD YANG Integration in martinthomson/internet-draft-template


Hi Med,

Another example could be my repo on YANG Push Lite:

https://github.com/rgwilton/draft-yp-observability/

I have used Martin's repo as a template, but I have a separate build file (https://github.com/rgwilton/draft-yp-observability/blob/main/build.mill) (using Mill rather than Make) to handle the YANG aspects, but still use Make for the underlying conversion from Markdown to draft + HTML.

The readme file associated with the repo https://github.com/rgwilton/draft-yp-observability/blob/main/README.md gives some instructions.  It is still somewhat a work in progress, but currently will (at least on Mac OS):

  *   Download RFCs & drafts revisions, download/install python venv & pyang, extract YANG files, fixed some mistakes, compiler and validates sets of modules together (using pyang, and also YANG lint, if installed on the path), builds various YANG trees and generates snippets from them.
  *   The generated assets can then be referenced into a markdown file.
  *   If you ask mill to watch local files ("./mill --watch all"), then it can automatically recompile locally if you change the build file, or any of the local YANG files, or the markdown source file, so you can keep a copy of the generated html open next to you and it will auto update YANG files, draft text, and tree diagrams whenever you save.

It also has a command that you can run to check if there are newer versions of any referenced drafts, e.g.:
rwilton@RWILTON-M-4RJ2 draft-yp-observability % ./mill checkDraftLatest
[1/1] checkDraftLatest
[1] Warning: draft-ietf-netconf-yang-notifications-versioning latest revsion is 8, using 7
[1] Warning: draft-ietf-netconf-yang-library-augmentedby latest revsion is 3, using 2
[1/1] ============================== checkDraftLatest ============================== 8s

The actual underlying build rules are currently in the repo here:
https://github.com/rgwilton/draft-yp-observability/blob/main/util_ietf.mill

But when I get the time, my plan to package the build rules as a versioned Jar file on Maven, which can then be trivially imported by the draft specific build file.

I haven't spent any time to hook this into github actions - but that is something else that I would probably also do.

Kind regards,
Rob


From: Florian Kauer <[e-mail]<mailto:[e-mail]>>
Date: Tuesday, 15 April 2025 at 03:54
To: [e-mail]<mailto:[e-mail]> <[e-mail]<mailto:[e-mail]>>, [e-mail]<mailto:[e-mail]> <[e-mail]<mailto:[e-mail]>>
Cc: Italo Busi <[e-mail]<mailto:[e-mail]>>
Subject: [netmod] Re: Call for volunteers for CI/CD YANG Integration in martinthomson/internet-draft-template
Hi all,

On 4/11/25 15:37, [e-mail]<mailto:[e-mail]> wrote:
> If you are interested to help with this, please drop us an email. A first meeting is schedule April 28.
I would also be interested in this discussion.

We are currently approaching the CI/CD YANG topic in the following way
https://github.com/Linutronix/yang-validation

It was used to work on draft-ietf-netmod-intf-ext-yang-16 and IEEE 802.1Qcw

Greetings,
Florian

_______________________________________________
netmod mailing list -- [e-mail]<mailto:[e-mail]>
To unsubscribe send an email to [e-mail]<mailto:[e-mail]>
____________________________________________________________________________________________________________
Ce message et ses pieces jointes peuvent contenir des informations confidentielles ou privilegiees et ne doivent donc
pas etre diffuses, exploites ou copies sans autorisation. Si vous avez recu ce message par erreur, veuillez le signaler
a l'expediteur et le detruire ainsi que les pieces jointes. Les messages electroniques etant susceptibles d'alteration,
Orange decline toute responsabilite si ce message a ete altere, deforme ou falsifie. Merci.

This message and its attachments may contain confidential or privileged information that may be protected by law;
they should not be distributed, used or copied without authorisation.
If you have received this email in error, please notify the sender and delete this message and its attachments.
As emails may be altered, Orange is not liable for messages that have been modified, changed or falsified.
Thank you.