This is a vagrant project that provides a virtual machine environment suitable for running an Apache HBase release.
Requires:
Unlock the local keyring before proceeding (this should prompt you for your GPG passphrase). For example, assuming you have an authentication key configured in your keyring, this will do the trick.
All terminal commands used below are assumed to be run with the current working directory as the location containing the Vagrantfile
.
The term “Host” is used to mean the environment that runs the Vagrant process. The term “Guest” is used to mean the virtual machine managed by the Host.
The ssh- and gpg-agent forwarding configuration used here assumes that your credentials work on the Host. Verify both are working before you proceed with the Guest. Additionally, using the credentials requires you to unlock the respective keyring, the state of which is persisted by the agent process or processes running on the Host.
See instructions in create-release
regarding proper configuration of ssh- and gpg-agents.
Assuming the git repo origin is on GitHub, the following command will ensure that your ssh credentials are working. On the Host, run:
host:~$ ssh -T git@github.com Hi <you>! You've successfully authenticated, but GitHub does not provide shell access.
Likewise, ensure you have an encryption key that can be used to sign a file. Again, on the Host, run:
host:~$ gpg --detach --armor --sign Vagrantfile host:~$ gpg --verify Vagrantfile.asc gpg: assuming signed data in 'Vagrantfile' ... host:~$ rm Vagrantfile.asc
Export the public portion of your signing credentials where the Guest can access it. Vagrant (+VirtualBox) shares the directory of the Vagrantfile
with the Linux Guest via the /vagrant
mount point. Any files present in this working directory on the Host are available to the Guest.
From the Host, run:
host:~$ gpg --export <you>@apache.org > gpg.<you>.apache.pub
Launch the Guest VM by running
host:~$ vagrant up
If anything about the Vagrant or VirtualBox environment have changed since you last used this VM, it's best to vagrant destroy -f
all local state and vagrant up
a fresh instance.
Connect to the Guest. This should forward your ssh- and gpg-agent session, as configured in the Vagrantfile
.
host:~$ vagrant ssh
Now that you're in the Guest VM, be sure that all gpg
command you issue include the --no-autostart
flag. This ensures that the gpg
process in the Guest communicates with the agent running on the Host OS rather than launching its own process on the Guest OS.
From the Guest, verify that ssh-agent forwarding is working, using the same test performed on the Host,
guest:~$ ssh -T git@github.com Hi <you>! You've successfully authenticated, but GitHub does not provide shell access.
From the Guest, import your exported public identity and verify the gpg-agent passthrough is working correctly.
guest:~$ gpg --no-autostart --import /vagrant/gpg.<you>.apache.pub ... gpg: Total number processed: 1 gpg: imported: 1 guest:~$ gpg --no-autostart --detach --armor --sign repos/hbase/pom.xml guest:~$ gpg --no-autostart --verify repos/hbase/pom.xml.asc gpg: assuming signed data in 'repos/hbase/pom.xml' ... guest:~$ rm repos/hbase/pom.xml.asc
Finally, you can initiate the release build. Follow the instructions in create-release
, i.e.,
guest:~$ mkdir ~/build-2.3.1-rc0 guest:~$ cd repos/hbase guest:~/repos/hbase$ ./dev-support/create-release/do-release-docker.sh -d ~/build-2.3.1-rc0/ ...