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

[[e-mail]]

Hi Benoît, all,

FWIW, here is an update of this effort :


  *   The template is ready for testing (https://github.com/IETF-OPS-AD/I-D-with-yang-template) In addition the I-D build part, the current version supports so far:
     *   Integrated YANG validation of any listed modules
     *   Modules with data nodes, modules with types and groupings only, modules with sx
     *   Automatic generation of trees (and their update)
  *   Rather than replicating YANG tools in every repo that will use the template, we offloaded all those to IETF-OPS-AD/I-D-with-yang-tools: I-D-with-yang-tools<https://github.com/IETF-OPS-AD/I-D-with-yang-tools> and point the template workflow to these.

I won't be able to attend the netmod session as I need to be in the joint bmwg/ippm session, but I can prepare some slides if needed. Thanks.

Cheers,
Med

De : Benoit Claise <[e-mail]>
Envoyé : mardi 15 juillet 2025 08:59
À : BOUCADAIR Mohamed INNOV/NET <[e-mail]>; [e-mail]
Cc : Italo Busi <[e-mail]>; Rob Wilton (rwilton) <[e-mail]>
Objet : Re: [netmod] Re: Call for volunteers for CI/CD YANG Integration in martinthomson/internet-draft-template



Dear all,

Nice initiative below.
I see that the current NETMOD agenda https://datatracker.ietf.org/doc/agenda-123-netmod/ has some free room.
Would it make sense to cover this below?

Regards, Benoit

On 4/29/2025 8:48 AM, [e-mail]<mailto:[e-mail]> wrote:
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]><mailto:[e-mail]>
Envoyé : mardi 22 avril 2025 16:38
À : Florian Kauer <[e-mail]><mailto:[e-mail]>; BOUCADAIR Mohamed INNOV/NET <[e-mail]><mailto:[e-mail]>; [e-mail]<mailto:[e-mail]>
Cc : Italo Busi <[e-mail]><mailto:[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):

  1.  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.
  2.  The generated assets can then be referenced into a markdown file.
  3.  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.



_______________________________________________

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.