[netmod] FW: New Version Notification for draft-rwilton-netmod-yang-packages-02.txt

"Rob Wilton (rwilton)" <rwilton@cisco.com> Thu, 24 October 2019 12:32 UTC

Return-Path: <rwilton@cisco.com>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 38CF81200E0 for <netmod@ietfa.amsl.com>; Thu, 24 Oct 2019 05:32:00 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -14.5
X-Spam-Level:
X-Spam-Status: No, score=-14.5 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_HI=-5, SPF_PASS=-0.001, URIBL_BLOCKED=0.001, USER_IN_DEF_DKIM_WL=-7.5] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=cisco.com header.b=KryVv91U; dkim=pass (1024-bit key) header.d=cisco.onmicrosoft.com header.b=JOSzm2Jp
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id rZbkkUgPs3U9 for <netmod@ietfa.amsl.com>; Thu, 24 Oct 2019 05:31:58 -0700 (PDT)
Received: from alln-iport-2.cisco.com (alln-iport-2.cisco.com [173.37.142.89]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 51031120026 for <netmod@ietf.org>; Thu, 24 Oct 2019 05:31:58 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=5186; q=dns/txt; s=iport; t=1571920318; x=1573129918; h=from:to:subject:date:message-id:references:in-reply-to: content-transfer-encoding:mime-version; bh=qVKQsjnefduKFMc5pXw+BGqkNzMJfRuz56dmtq60q+U=; b=KryVv91Ukql0binAv33+ciyisTISh0ZxFmVWUiedZDDK0GuDIiwpKztZ fhRIAQ8PpB+prg89rfzRMP7oGGwKyQmIC6B6xkFNzwj1UFdVb0RswWr4b YELBmseEZXuls6rBGDRguapF2vPTVld+V+5GTHR1Zt3trm+aRAcJov55k 0=;
IronPort-PHdr: =?us-ascii?q?9a23=3ApXQGhR9Fh5Vx7/9uRHGN82YQeigqvan1NQcJ65?= =?us-ascii?q?0hzqhDabmn44+8ZB7E/fs4iljPUM2b8P9Ch+fM+4HYEW0bqdfk0jgZdYBUER?= =?us-ascii?q?oMiMEYhQslVdSaCEnnK/jCZC0hF8MEX1hgrDm2?=
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: =?us-ascii?q?A0BoAACkmLFd/4QNJK1lHAEBAQEBBwE?= =?us-ascii?q?BEQEEBAEBgWcHAQELAYFKUAVsVyAECyoKhB6DRwOEWIYJToIQmAOBLoEkA1Q?= =?us-ascii?q?JAQEBDAEBJQgCAQGBTIJ0AheDJiQ0CQ4CAwkBAQQBAQECAQUEbYU3AQuFUAE?= =?us-ascii?q?BAQEDEhERDAEBNQMLBAIBCBEEAQEDAiYCAgIwFQYBAQUDAgQKCQgTB4MBgkY?= =?us-ascii?q?DLgECDKdhAoE4iGF1gTKCfgEBBYE4Ag5Bgn8YghcJgQ4oAYwOGIFAP4ERRoJ?= =?us-ascii?q?MPoJiAQECAQEWgTEYgw4ygiyNDzCCOYVfmBAKgiSHD442gjtyhmKPQ445iCm?= =?us-ascii?q?RIwIEAgQFAg4BAQWBUjmBWHAVGoMNCUcQFIMGg3OFFIU/dAGBKI1bAYEpAQE?=
X-IronPort-AV: E=Sophos;i="5.68,224,1569283200"; d="scan'208";a="357427890"
Received: from alln-core-10.cisco.com ([173.36.13.132]) by alln-iport-2.cisco.com with ESMTP/TLS/DHE-RSA-SEED-SHA; 24 Oct 2019 12:31:57 +0000
Received: from XCH-RCD-009.cisco.com (xch-rcd-009.cisco.com [173.37.102.19]) by alln-core-10.cisco.com (8.15.2/8.15.2) with ESMTPS id x9OCVvS0011436 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=FAIL) for <netmod@ietf.org>; Thu, 24 Oct 2019 12:31:57 GMT
Received: from xhs-aln-003.cisco.com (173.37.135.120) by XCH-RCD-009.cisco.com (173.37.102.19) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Thu, 24 Oct 2019 07:31:56 -0500
Received: from xhs-aln-003.cisco.com (173.37.135.120) by xhs-aln-003.cisco.com (173.37.135.120) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Thu, 24 Oct 2019 07:31:55 -0500
Received: from NAM01-BY2-obe.outbound.protection.outlook.com (173.37.151.57) by xhs-aln-003.cisco.com (173.37.135.120) with Microsoft SMTP Server (TLS) id 15.0.1473.3 via Frontend Transport; Thu, 24 Oct 2019 07:31:55 -0500
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=eIrGypJm/9dLkJUjyTyI61wPidpVQBIBb7CxxeeSlZeNkRZDZYTMfaO251uPgNosFmrFVA21dgs8r98eBLdacwMQ2bp/eJnSBXDM6U2aQUhs7utL9yRXpACkU0EssbutsD6gIvFl+a7SKo44xyG2/U4KKAMWaJKW+cm/wMbAibTPknkUtnWT7yXsjsyt2M5sbSLNdKB3mSx31/M/rO1YDeQb3lD+gfKXyENaI2rJF3kghbcVMZ1++XbQP8H+e3O7Vk3X9eiz8KA1H8K1yvrSEbcety1jcAbrnNVah5zJm0Xw++V1S4Qiv+ih7hNOIvIUYmpCEXu7RdrdIa5/sblzvA==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=qVKQsjnefduKFMc5pXw+BGqkNzMJfRuz56dmtq60q+U=; b=G2CiD9QHt3e43NUAv7ivPgMo/Pt+zp5h9tur5sMU9Ug+tODQ0ZIpVZg5JXwcZwjXwZDtOhZ2O1eEyowBKX0IEGsu7Z1JgeUU9IdraZdqkI5OfDx3KjpV9pH5rGobrUmveeffAaxRHQWmNw931iysvbiUcmycSo7W02nGPur44yalpLo31G92+YWHRM1Il0lKFg1MyCIveew+rp2ghUJOeLSx6GBZbG8EjzBJg/rfH5ykGblp1uHVeHaiefeCOj+l3rBerrUS5xIWCh7x9uYPhhmoGq8BtFNk8Xaz7yvhhE0kClBWYxLBksrDFW2bNwsVbzeDtN/+AbUUi+GkMAtOhQ==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=cisco.com; dmarc=pass action=none header.from=cisco.com; dkim=pass header.d=cisco.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cisco.onmicrosoft.com; s=selector2-cisco-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=qVKQsjnefduKFMc5pXw+BGqkNzMJfRuz56dmtq60q+U=; b=JOSzm2Jp6xnsOD2t1VGJXFJ9M9mN2fKGdg8B1ZfJQR+DX9YzGxCtGCUCSrODHYAAS1s6B+gS1VUuhcZ/u0E1mXITjICwfH+vxFdayMg06cCYCehYq4wPNb75fC/Xxi1yTOu2u3TWWz6hLWMk2GUGkSUDn74lR+PDsX54Km814aM=
Received: from MN2PR11MB4366.namprd11.prod.outlook.com (52.135.38.209) by MN2PR11MB4127.namprd11.prod.outlook.com (10.255.181.95) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2367.24; Thu, 24 Oct 2019 12:31:42 +0000
Received: from MN2PR11MB4366.namprd11.prod.outlook.com ([fe80::cca:41bd:b0bb:c549]) by MN2PR11MB4366.namprd11.prod.outlook.com ([fe80::cca:41bd:b0bb:c549%2]) with mapi id 15.20.2347.030; Thu, 24 Oct 2019 12:31:42 +0000
From: "Rob Wilton (rwilton)" <rwilton@cisco.com>
To: "netmod@ietf.org" <netmod@ietf.org>
Thread-Topic: New Version Notification for draft-rwilton-netmod-yang-packages-02.txt
Thread-Index: AQHVimWTlsP2LGs2qka3gJEp8fWwEKdptuOw
Date: Thu, 24 Oct 2019 12:31:42 +0000
Message-ID: <MN2PR11MB4366CB080B0B8AD50062B3A6B56A0@MN2PR11MB4366.namprd11.prod.outlook.com>
References: <157191938274.11543.13727980027645330981.idtracker@ietfa.amsl.com>
In-Reply-To: <157191938274.11543.13727980027645330981.idtracker@ietfa.amsl.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
authentication-results: spf=none (sender IP is ) smtp.mailfrom=rwilton@cisco.com;
x-originating-ip: [173.38.220.40]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 82347b1b-ca05-42b0-4cce-08d7587e2025
x-ms-traffictypediagnostic: MN2PR11MB4127:
x-ms-exchange-purlcount: 5
x-microsoft-antispam-prvs: <MN2PR11MB41273FA6C54D4FBE43DBDC4CB56A0@MN2PR11MB4127.namprd11.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:7691;
x-forefront-prvs: 0200DDA8BE
x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(4636009)(376002)(39860400002)(136003)(366004)(396003)(346002)(199004)(189003)(13464003)(51444003)(6436002)(25786009)(316002)(66066001)(71200400001)(71190400001)(74316002)(8936002)(86362001)(64756008)(66946007)(76116006)(476003)(5640700003)(66446008)(66476007)(446003)(66556008)(229853002)(486006)(15650500001)(55016002)(966005)(52536014)(9686003)(7696005)(76176011)(1730700003)(8676002)(99286004)(6306002)(2473003)(11346002)(3846002)(6116002)(81156014)(5660300002)(81166006)(186003)(33656002)(14444005)(2351001)(478600001)(26005)(66574012)(4001150100001)(53546011)(6916009)(2906002)(6506007)(256004)(14454004)(2501003)(305945005)(102836004)(7736002); DIR:OUT; SFP:1101; SCL:1; SRVR:MN2PR11MB4127; H:MN2PR11MB4366.namprd11.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1;
received-spf: None (protection.outlook.com: cisco.com does not designate permitted sender hosts)
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: DZSn4sWvY5Et8sZcQbRbwusv1C49Gbyfoo7fl/2Lxnw77royQthNYNbDvaCqZNEz8U0f8s/mSmMiR08Z3ojHaLIhqI3LMC2IHGnjHGbLdsXtbXQycfVp7rqRw2KazRC4Nu3xHJm6hiGv1PnG6foADyI6fkjrKa9a3tcUr3C914VjYsYxSb+vCWxRl15iPb4/TW3cjM0v5LE8rvPLPSjFqtOHWLkk3kVCfN5r18L7xdowAg80/LYwL9PeA2I3tXQS80Cbtle+C5VpwSxN0vv+4qGEKk9FWfpryvI8FZ2rw25cXoRFzz19/2kqTYLFzX8YkXypaS0X24iexVEPWuNzOxRAEHONQeXonrH2LFBDDIMiHSNaFG8tEQy8ZM+DG72XWveEXDICzQwtoGxOSbjXc3vGkCuGHbL7l3spGqFiaQdied99KfQ+IOJtEOaDpzoIkphblML1wdUQ8/n+4wNRNWdtnRnw1O905ShLoGmFtX4=
x-ms-exchange-transport-forked: True
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: 82347b1b-ca05-42b0-4cce-08d7587e2025
X-MS-Exchange-CrossTenant-originalarrivaltime: 24 Oct 2019 12:31:42.4053 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 5ae1af62-9505-4097-a69a-c1553ef7840e
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: +xNp8IzbeUPFAqNKGdFA55Dh1x+G92Pz8JbPTJdtPoBuXcIJgiCAQWb0FSY+YjrMz+y7u7vy2t9TN8O1jxqD2A==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR11MB4127
X-OriginatorOrg: cisco.com
X-Outbound-SMTP-Client: 173.37.102.19, xch-rcd-009.cisco.com
X-Outbound-Node: alln-core-10.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/WEH3Sr9VZo_VIwgolm9L9m628UY>
Subject: [netmod] FW: New Version Notification for draft-rwilton-netmod-yang-packages-02.txt
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 24 Oct 2019 12:32:00 -0000

The third draft document from the versioning design team is the updated YANG packages draft.

IIRC, the significant changes are:
 - re-alignment to the changes in module versioning (e.g. the revision-label/semver split)
 - adding support for checksums (based on SHA-256)
 - locally scoped packages to a device, primarily intended to changed schema changes due to a hotfix/patch to the software.

Feedback/comments on the entire draft is of course helpful/welcome.  But whilst reading the document, there are some specific open questions on which WG feedback is solicited:


1) Should packages use different structures for the file vs the device?

The current approach aims to optimize for readability in the file and data transfer on the device (by reusing YANG library module-sets).

One alternative is to use the same structure on both, with a duplication on module metadata information on the server by not reusing the YANG library module-sets.


2) The new version of the packages draft uses SHA-256 checksums on module, sub-module, and included package definitions.  Normally, a SHA-256 checksum is 64 characters long, but we could allow a prefix of the checksum to optionally be used in the files instead (i.e. similarly to how git commit hashes are handled).


3) Packages are allowed to use "tags" (from draft-ietf-netmod-module-tags) to add extra metadata to a package.  Currently, the draft doesn't provide any mechanism to add, remove, modify the tags associated with a package on a device.  Should this be added, or can this work reasonably be deferred?


4) The package definitions examples don't include/require XML namespaces.  Allowing, but not requiring, these in a package definition seems OK, but I prefer a solution that expects that package and module names to be unique (which, for modules at least, I think that the YANG JSON encoding effectively requires?).


5) I presume that we should try and define an IANA registry for package definitions, similar to the IANA YANG module registry.  Arguably, it might be more useful if the registry could be wider than just IETF modules.

Thanks,
Rob


-----Original Message-----
From: internet-drafts@ietf.org <internet-drafts@ietf.org> 
Sent: 24 October 2019 13:16
To: Rob Wilton (rwilton) <rwilton@cisco.com>
Subject: New Version Notification for draft-rwilton-netmod-yang-packages-02.txt


A new version of I-D, draft-rwilton-netmod-yang-packages-02.txt
has been successfully submitted by Robert Wilton and posted to the IETF repository.

Name:		draft-rwilton-netmod-yang-packages
Revision:	02
Title:		YANG Packages
Document date:	2019-10-23
Group:		Individual Submission
Pages:		57
URL:            https://www.ietf.org/internet-drafts/draft-rwilton-netmod-yang-packages-02.txt
Status:         https://datatracker.ietf.org/doc/draft-rwilton-netmod-yang-packages/
Htmlized:       https://tools.ietf.org/html/draft-rwilton-netmod-yang-packages-02
Htmlized:       https://datatracker.ietf.org/doc/html/draft-rwilton-netmod-yang-packages
Diff:           https://www.ietf.org/rfcdiff?url2=draft-rwilton-netmod-yang-packages-02

Abstract:
   This document defines YANG packages, a versioned organizational
   structure holding a set of related YANG modules, that collectively
   define a YANG schema.  It describes how YANG instance data documents
   are used to define YANG packages, and how the YANG library
   information published by a server can be augmented with packages
   related information.

                                                                                  


Please note that it may take a couple of minutes from the time of submission until the htmlized version and diff are available at tools.ietf.org.

The IETF Secretariat