[Netmod-ver-dt] YANG packages - ready to post?

"Rob Wilton (rwilton)" <rwilton@cisco.com> Tue, 22 October 2019 15:25 UTC

Return-Path: <rwilton@cisco.com>
X-Original-To: netmod-ver-dt@ietfa.amsl.com
Delivered-To: netmod-ver-dt@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 5CBD71200E7 for <netmod-ver-dt@ietfa.amsl.com>; Tue, 22 Oct 2019 08:25:59 -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=a1QJy9FO; dkim=pass (1024-bit key) header.d=cisco.onmicrosoft.com header.b=XnPbE8P4
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 L0QzcozgWhdR for <netmod-ver-dt@ietfa.amsl.com>; Tue, 22 Oct 2019 08:25:57 -0700 (PDT)
Received: from rcdn-iport-6.cisco.com (rcdn-iport-6.cisco.com [173.37.86.77]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id E77441200DB for <netmod-ver-dt@ietf.org>; Tue, 22 Oct 2019 08:25:56 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=3248; q=dns/txt; s=iport; t=1571757956; x=1572967556; h=from:to:subject:date:message-id: content-transfer-encoding:mime-version; bh=7qJVDObkNt8tM1b3qWiygT0b/B8A5k8rIrR53HK14fg=; b=a1QJy9FOMZbjW2DH7hiNa1hHXLkCV2F6qn/SBuc+MshKqVH6H+oLnwyR pFdOFVIZd0zg4UKXBMdjPzNwqMJm5aQEbSBO8NROdX6W4SRkIhO15iMNS nToUSDye5oFnl+unskbHhvS7OwG71B3SbJ94aATWYF6HRh5AjCDdnbcWY s=;
IronPort-PHdr: 9a23:nwOyCR2lj8UaGRdhsmDT+zVfbzU7u7jyIg8e44YmjLQLaKm44pD+JxKHt+51ggrPWoPWo7JfhuzavrqoeFRI4I3J8RVgOIdJSwdDjMwXmwI6B8vQE1L6KOLtaQQxHd9JUxlu+HToeUU=
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: A0CgAAC2Hq9d/5ldJa1lHAEBAQEBBwEBEQEEBAEBgWcHAQELAYFKUAVsVyAECyoKh2MDhFiGAE2CD5gDgS6BJANUCQEBAQwBARgNCAIBAYN7RQKDKiQ0CQ4CAwkBAQQBAQECAQUEbYU3AQuFSwEBAQUBECgGAQEsDAsGARkDAQEBHzcLHQkBBAoJCBMHgwGCRgMuAQIMpwUCgTiIYYIngn4BAQWBNAGDUhiCFwMGgTYBjA4YgUA/gRFGhWwBAYFLGINAgiyNDwOgUAqCJIcOjjOCO4dTj0CEOol8iCeRIAIEAgQFAg4BAQWBUjkqgS5wFTuCbFAQFIMGg3OFFIU/dAqBH41YAYEjAQE
X-IronPort-AV: E=Sophos;i="5.68,216,1569283200"; d="scan'208";a="651934276"
Received: from rcdn-core-2.cisco.com ([173.37.93.153]) by rcdn-iport-6.cisco.com with ESMTP/TLS/DHE-RSA-SEED-SHA; 22 Oct 2019 15:25:55 +0000
Received: from XCH-RCD-009.cisco.com (xch-rcd-009.cisco.com [173.37.102.19]) by rcdn-core-2.cisco.com (8.15.2/8.15.2) with ESMTPS id x9MFPtH3031516 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=FAIL) for <netmod-ver-dt@ietf.org>; Tue, 22 Oct 2019 15:25:55 GMT
Received: from xhs-rtp-003.cisco.com (64.101.210.230) by XCH-RCD-009.cisco.com (173.37.102.19) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Tue, 22 Oct 2019 10:25:55 -0500
Received: from xhs-aln-001.cisco.com (173.37.135.118) by xhs-rtp-003.cisco.com (64.101.210.230) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Tue, 22 Oct 2019 11:25:54 -0400
Received: from NAM02-SN1-obe.outbound.protection.outlook.com (173.37.151.57) by xhs-aln-001.cisco.com (173.37.135.118) with Microsoft SMTP Server (TLS) id 15.0.1473.3 via Frontend Transport; Tue, 22 Oct 2019 10:25:54 -0500
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=cDHz+O1NkwsiUUfDxy3+jDPIQF3jcwsru0HA1wvUzrz7xO4pOXdxYcW2FWVq8g12XW3uhTI2Kx63Jpg6dXxVIddrVXltAhELIXZzOb/TDjr3wFvqJfBVDBVyR/RCBk6/VpP0Mle0HbREumknMvGTeM7AP9uWq91zdASMO3kuRcM8TPj6kb/+AJRaMwnNE0mNtlLy1nMDu1lSWFw1PtnFLHD7n7KHCnfARG9WWJIzUZqXXefH507iKmYrNxaYJqJKrwMq8HkW8OY1S8OgFV+weO+58wMrUfzaTSgPAn8uQhdBh/DPYeQZaklI6o0j0IPZ2SANG+1ibPpvx2mOuFy3iQ==
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=c1D/p8RS859WsvAzZgLl9J13UMaXpgPRhT3XA7gVrt0=; b=lpjkU0XWZ3UdjoewN1BlrjMV/CoTs0hc8S7MtE2N4CSGFfCB+a5oEaNZyrUXA3/uK9nIxFLJ1ur0hqBz/DH5D8UF5vwzmC/TOVL1fbKd1FYYUblyJtST1U6EVNUp5zaS0RkoartmwO626Vu+IM488QfgcwfyEbpg6Nc5TrXHOz8acnuKlF3c9mS8XU/oypIf+qJ1aY2hGfcrN0pfH4ZRZEVdzilIHnTqzEi17STc0HlZu/MQYWSZa86DlqLCf+UZ9o9da4RNz3HbJANr4Z50a845EROcOYidwJj6amggBuYM253nisotQAjFjl+B33pACdxD25QbMQ/4EL5shfxv6g==
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=c1D/p8RS859WsvAzZgLl9J13UMaXpgPRhT3XA7gVrt0=; b=XnPbE8P47flds0dDN+JLdjiMgFfJUJzS33NXhNjmPd+iloEBZdJRGuR64RcI18M5KrNFvdftXr5EQbn4ne5lQEtWk1mgn0pIHTjCy66b3Pk6O5b/E8pXUHFQbceVB4MYrqUxkFOWB+aVdoV+mCinHMLLGGe5XfMX5c6I/xciQ4g=
Received: from MN2PR11MB4366.namprd11.prod.outlook.com (52.135.38.209) by MN2PR11MB4205.namprd11.prod.outlook.com (52.135.39.87) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2347.16; Tue, 22 Oct 2019 15:25:53 +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.029; Tue, 22 Oct 2019 15:25:53 +0000
From: "Rob Wilton (rwilton)" <rwilton@cisco.com>
To: "netmod-ver-dt@ietf.org" <netmod-ver-dt@ietf.org>
Thread-Topic: YANG packages - ready to post?
Thread-Index: AdWI7PxwiSyo1zMcS9u6Hd3c35mz3g==
Date: Tue, 22 Oct 2019 15:25:53 +0000
Message-ID: <MN2PR11MB436664DB3D394D933EB8876DB5680@MN2PR11MB4366.namprd11.prod.outlook.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: 14b793cf-f3a2-4dc3-5f85-08d7570420b4
x-ms-traffictypediagnostic: MN2PR11MB4205:
x-ms-exchange-purlcount: 3
x-microsoft-antispam-prvs: <MN2PR11MB420539F75D32FB6A35EEFBE8B5680@MN2PR11MB4205.namprd11.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:10000;
x-forefront-prvs: 01986AE76B
x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(4636009)(39860400002)(346002)(136003)(396003)(366004)(376002)(199004)(189003)(51444003)(13464003)(76116006)(14454004)(66446008)(66556008)(186003)(53546011)(966005)(6506007)(3846002)(26005)(6116002)(5660300002)(7736002)(64756008)(8676002)(71200400001)(99286004)(7696005)(66476007)(66946007)(52536014)(102836004)(305945005)(5640700003)(66066001)(55016002)(71190400001)(86362001)(74316002)(2906002)(25786009)(476003)(6916009)(9686003)(6306002)(486006)(81156014)(81166006)(33656002)(8936002)(478600001)(4001150100001)(316002)(256004)(14444005)(6436002)(2501003)(2351001); DIR:OUT; SFP:1101; SCL:1; SRVR:MN2PR11MB4205; 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: Z8k1nmajigfJITf3nhHTOtr49Qk0cqcyr2f7PdFJYPmh8A0zNHGyYxOgj7Pk5Z5JKOe2hMdvCokCSQ2A+tG/ZQ03OX8MurMrLRsHeNVBF2kv679zCIRkXCjDkGhZLuUW9wQj3cfSapJiM0g8dOTpasYO7J0ybPJHtUdXA95yBz7Q8dw9vuUAclBSshx7MoS1yzwWpQQTc7z9a7uhrdqQ70GaLJKRnSd9XfiV2UkC0r+325bbDi7ZO8uQ9SEvbuNdOO7izWBCYgpxH93BmXg1rJ8zq2DXcTq2SLVHlby6HT+1NxpPYtOmcQxOTD2b+B5BOpjieqL1PVcFV0XDOV+g9Jzg5pdQdefUrSTD8AZryD9UO16tHVRRDYhswk78X7eiRCcCEy2fMLmSLshQjF0/uzE3fpPCv1azh3m8gquc6/ztNCL1WqIUGIvXh4ACL7i93w4KDV2BARvqcmuOyhod2IdwJJkv4U754TMP5hh6XGk=
x-ms-exchange-transport-forked: True
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: 14b793cf-f3a2-4dc3-5f85-08d7570420b4
X-MS-Exchange-CrossTenant-originalarrivaltime: 22 Oct 2019 15:25:53.5392 (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: WO+SSEQmNVLkjzZu9DD+WML17pzaOEg+6SspSuD1j/D+eaqDt7yDXa670nb9SdEtYYHmJQtEBzjesbyOs80upg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR11MB4205
X-OriginatorOrg: cisco.com
X-Outbound-SMTP-Client: 173.37.102.19, xch-rcd-009.cisco.com
X-Outbound-Node: rcdn-core-2.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod-ver-dt/eHnSTZT_ztynmODevH3owC7oRGQ>
Subject: [Netmod-ver-dt] YANG packages - ready to post?
X-BeenThere: netmod-ver-dt@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NetMod WG YANG Model Versioning Design Team <netmod-ver-dt.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod-ver-dt>, <mailto:netmod-ver-dt-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod-ver-dt/>
List-Post: <mailto:netmod-ver-dt@ietf.org>
List-Help: <mailto:netmod-ver-dt-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod-ver-dt>, <mailto:netmod-ver-dt-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 22 Oct 2019 15:25:59 -0000

Hi,

I think that I have hopefully resolved the main points that came up in review (principally except whether we have different structures for the file vs the device).

I think that it would be good to get the current version posted to the WG, but if anyone wants to review/check my markups before I post, please let me know before Thursday's meeting.

When I send it to the WG, I intend to also point out some of the open questions that they may want to consider or comment on.  Of course comments on the rest of the draft will also be welcome.

The questions are:


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: Netmod-ver-dt <netmod-ver-dt-bounces@ietf.org> On Behalf Of Robert Wilton
Sent: 22 October 2019 11:07
To: netmod-ver-dt@ietf.org
Subject: [Netmod-ver-dt] [rgwilton/YANG-Packages-Draft] 72951e: Further markups

  Branch: refs/heads/master
  Home:   https://github.com/rgwilton/YANG-Packages-Draft
  Commit: 72951e88a99d3f412838badf9f9485e368d6ddd5
      https://github.com/rgwilton/YANG-Packages-Draft/commit/72951e88a99d3f412838badf9f9485e368d6ddd5
  Author: rwilton <rwilton@cisco.com>
  Date:   2019-10-22 (Tue, 22 Oct 2019)

  Changed paths:
    M draft-rwilton-netmod-yang-packages.txt
    M draft-rwilton-netmod-yang-packages.xml
    M ietf-yang-inst-data-pkg.yang
    M ietf-yang-package-types.yang
    M ietf-yang-package.yang
    M ietf-yl-packages.yang

  Log Message:
  -----------
  Further markups


_______________________________________________
Netmod-ver-dt mailing list
Netmod-ver-dt@ietf.org
https://www.ietf.org/mailman/listinfo/netmod-ver-dt