Bug#897230: qa.debian.org: the instructions for UDD development do not work

[Nicolas Braud-Santoni <nicolas@braud-santoni.eu>]

Package: qa.debian.org
Severity: normal
Tags: patch

Dear UDD maintainer,

While attempting to make a patch for #897228, I discovered that the
instructions in [the wiki](https://wiki.debian.org/UltimateDebianDatabase/Hacking)
to setup a UDD development environment do not work:

- Vagrantfile refers to a local/contrib-stretch base box that
  probably only exists on your machine; please use debian/stretch64 or somesuch.
- `vagrant up` fails because the repository contains dangling symlinks
  that rsync refuses to copy.

I am including patches for those issues.


Unfortunately, none of the scripts under `vagrant/` that are offered to get
real UDD data for development will work for anyone but you: both assume SSH
access to ullman.debian.org, as user lucas.

Would it be possible instead to have UDD publish regular database dumps,
compressed and served over HTTPS?  As far as I understand, UDD only contains
public data, and this would make it possible for other people to contribute to
UDD :)


Best,

  nicoo

-- System Information:
Debian Release: buster/sid
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'unstable-debug'), (500, 'testing-debug'), (500, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 4.15.0-3-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8) (ignored: LC_ALL set to en_US.UTF-8), LANGUAGE=en_US.UTF-8 (charmap=UTF-8) (ignored: LC_ALL set to en_US.UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

>From 4920a15185487dc6a5bd0c63f3a9e9fae210dc39 Mon Sep 17 00:00:00 2001
From: Nicolas Braud-Santoni <nicolas@braud-santoni.eu>
Date: Mon, 30 Apr 2018 14:36:49 +0200
Subject: [PATCH 1/3] gitignore the .vagrant directory

---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.gitignore b/.gitignore
index d791b0f..4a8e0eb 100644
--- a/.gitignore
+++ b/.gitignore
@@ -10,3 +10,4 @@ web/how-can-i-help.json.gz
 debian.bib
 debian.pdf
 debian.tex
+/.vagrant
\ No newline at end of file
-- 
2.17.0

>From a636d2cf41d39df1bc7a5f2ae668479a26ae1a66 Mon Sep 17 00:00:00 2001
From: Nicolas Braud-Santoni <nicolas@braud-santoni.eu>
Date: Mon, 30 Apr 2018 14:37:57 +0200
Subject: [PATCH 2/3] Vagrantfile: Use a base box that is globally available

---
 Vagrantfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Vagrantfile b/Vagrantfile
index 3aac1db..e19546f 100644
--- a/Vagrantfile
+++ b/Vagrantfile
@@ -2,7 +2,7 @@
 # vi: set ft=ruby :
 
 Vagrant.configure(2) do |config|
-  config.vm.box = "local/contrib-stretch"
+  config.vm.box = "debian/stretch64"
 
   config.vm.network "forwarded_port", guest: 80, host: 8080
 
-- 
2.17.0

>From 3e5eba28fbcfd55593551fcb6d31ba59d1951bbd Mon Sep 17 00:00:00 2001
From: Nicolas Braud-Santoni <nicolas@braud-santoni.eu>
Date: Mon, 30 Apr 2018 14:48:34 +0200
Subject: [PATCH 3/3] Vagrantfile: Allow symlinks in the shared folder

---
 Vagrantfile | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Vagrantfile b/Vagrantfile
index e19546f..46c422b 100644
--- a/Vagrantfile
+++ b/Vagrantfile
@@ -8,6 +8,7 @@ Vagrant.configure(2) do |config|
 
   config.vm.provider "virtualbox" do |vb|
     vb.memory = "4096"
+    vb.customize ["setextradata", :id, "VBoxInternal2/SharedFoldersEnableSymlinksCreate/v-root", "1"]
   end
 
   config.vm.provision "shell", path: "vagrant/provision.sh"
-- 
2.17.0