Re: [TOOLS-DEVELOPMENT] Backing up Github WG repositories

Robert Sparks <rjsparks@nostrum.com> Thu, 27 February 2020 20:55 UTC

Return-Path: <rjsparks@nostrum.com>
X-Original-To: tools-development@ietfa.amsl.com
Delivered-To: tools-development@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id A9F983A0C1D for <tools-development@ietfa.amsl.com>; Thu, 27 Feb 2020 12:55:35 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.403
X-Spam-Level:
X-Spam-Status: No, score=-1.403 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, KHOP_HELO_FCRDNS=0.276, T_SPF_HELO_PERMERROR=0.01, T_SPF_PERMERROR=0.01, URIBL_BLOCKED=0.001] autolearn=no autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=fail (1024-bit key) reason="fail (message has been altered)" header.d=nostrum.com
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 ts6fmPOcIHDQ for <tools-development@ietfa.amsl.com>; Thu, 27 Feb 2020 12:55:34 -0800 (PST)
Received: from nostrum.com (raven-v6.nostrum.com [IPv6:2001:470:d:1130::1]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 648613A0BF7 for <tools-development@ietf.org>; Thu, 27 Feb 2020 12:55:34 -0800 (PST)
Received: from unescapeable.local ([47.186.30.41]) (authenticated bits=0) by nostrum.com (8.15.2/8.15.2) with ESMTPSA id 01RKtWuY097324 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128 verify=NO); Thu, 27 Feb 2020 14:55:33 -0600 (CST) (envelope-from rjsparks@nostrum.com)
DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=nostrum.com; s=default; t=1582836933; bh=RLvpnJ3u+HktjuGWxHxcweT3NwSr1snCZKoqlt0p3qs=; h=Subject:To:References:From:Date:In-Reply-To; b=uFq4+RMg9OFEYymkLDb6OUGhF7TVuIziUEhYwRugw347g1Nbd/dctYJpi2r/KIBu3 kz4LexTAbBit59Fh7nMeoq6I+9n3TfH/cQf1sm5yHgLr/ehfuluBP23TfeUPI4iGeC fLdbuq/rOEy+R+HPEYv6k9L8hUaf46KxQFDBS2K4=
X-Authentication-Warning: raven.nostrum.com: Host [47.186.30.41] claimed to be unescapeable.local
To: Martin Thomson <mt@lowentropy.net>, IETF Tools Development <tools-development@ietf.org>
References: <9de49701-4477-291a-9a98-a39feb819a44@nostrum.com> <66380131-5b4e-4fa4-860c-08b240929e7f@www.fastmail.com> <2acd5e5e-0a1e-7658-964f-ca8d881b76f2@nostrum.com> <a3b33093-03d4-4c78-b5d4-8709f60b9fd6@www.fastmail.com> <9eaed56c-6fb8-6037-3bcf-14776ac2f328@nostrum.com> <7d0e1230-7fab-4aed-bc64-55a4ca8438ad@www.fastmail.com>
From: Robert Sparks <rjsparks@nostrum.com>
Message-ID: <d53cd207-8e52-7b30-d2a6-ca9cbe8b4c7e@nostrum.com>
Date: Thu, 27 Feb 2020 14:55:31 -0600
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:68.0) Gecko/20100101 Thunderbird/68.5.0
MIME-Version: 1.0
In-Reply-To: <7d0e1230-7fab-4aed-bc64-55a4ca8438ad@www.fastmail.com>
Content-Type: text/plain; charset="utf-8"; format="flowed"
Content-Transfer-Encoding: 7bit
Content-Language: en-US
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-development/UeQW_t0u51-FYWPCwGDPa4yg04U>
Subject: Re: [TOOLS-DEVELOPMENT] Backing up Github WG repositories
X-BeenThere: tools-development@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Tools Development list server <tools-development.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-development>, <mailto:tools-development-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-development/>
List-Post: <mailto:tools-development@ietf.org>
List-Help: <mailto:tools-development-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-development>, <mailto:tools-development-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 27 Feb 2020 20:55:42 -0000

On 2/26/20 5:56 PM, Martin Thomson wrote:
> On Wed, Feb 26, 2020, at 14:32, Robert Sparks wrote:
>>> To download an archive of your repository, you can use the API for user or organization migrations. For more information, see "Migrations <https://developer.github.com/v3/migrations/>" in the GitHub Developer documentation.
>> Now, it's clear from the warnings about the API changing without
>> advance notice during the preview period that this is not yet stable,
>> but it is what they aim people at right now.
>>
>> Do you read their documentation differently?
> https://developer.github.com/v3/migrations/users/#download-a-user-migration-archive is a more targeted link.  I don't know about the format of the dump you get.

You have to do the steps before it on that page before there's anything 
to download.

Specifically: 
https://developer.github.com/v3/migrations/users/#start-a-user-migration 
will have had to have succeeded (it's where you get :migration_id, and 
https://developer.github.com/v3/migrations/users/#start-a-user-migration 
will have to have been checked to see that the migration has finished 
successfully.

And one more thing to consider: This whole API requires providing the 
credentials of an _owner_ of the repository being backed up. I suspect 
that means we'll have an identity that we ask WG draft repositories to 
add as an owner. Does that match your expectations?

>
>> So, we
>> clearly specify that we have a requirement to capture labels and
>> comments, and leave it to the bidders to propose tools that will do
>> that, yes? We can make sure the language where we point to potential
>> solutions doesn't imply they are fit, or preferred.
> Sounds good.  Thanks.