mirror of
https://github.com/VCMP-SqMod/SqMod.git
synced 2025-07-25 18:21:47 +02:00
bin
cmake
module
Base
Core
Entity
Library
Misc
Vendor
AES256
B64
Hash
MDBC
MaxmindDB
bin
cmake
dev-bin
doc
include
projects
src
t
AUTHORS
CMakeLists.txt
Changes.md
LICENSE
Makefile.am
NOTICE
README.dev.md
README.md
appveyor.yml
bootstrap
common.mk
configure.ac
PUGIXML
SQLite
SimpleIni
TinyDir
Whirlpool
CMakeLists.txt
CMakeLists.txt
Core.cpp
Core.hpp
Logger.cpp
Logger.hpp
Main.cpp
Register.cpp
SqBase.hpp
sdk
sqrat
squirrel
vcmp
.gitignore
CMakeLists.txt
LICENSE
README.md
70 lines
3.0 KiB
Markdown
70 lines
3.0 KiB
Markdown
# Releasing this library
|
|
|
|
We release by uploading the tarball to GitHub, uploading Ubuntu PPAs, and by
|
|
updating the Homebrew recipe for this library.
|
|
|
|
## Creating the release tarball
|
|
You may want to refer to the section about prerequisites.
|
|
|
|
* Check whether there are any open issues to fix while you're doing this.
|
|
* Update `Changes.md` to include specify the new version, today's date, and
|
|
list relevant changes. Commit this.
|
|
* Run `./dev-bin/release.sh` to update various files in the distro, our
|
|
GitHub pages, and creates a GitHub release with the tarball.
|
|
* Check the release looks good on both GitHub and launchpad.net.
|
|
|
|
## PPA
|
|
|
|
In order to upload a PPA, you have to create a launchpad.net account and
|
|
register a GPG key with that account. You also need to be added to the MaxMind
|
|
team. Ask in the dev channel for someone to add you. See
|
|
https://help.launchpad.net/Packaging/PPA for more details.
|
|
|
|
The PPA release script is at `dev-bin/ppa-release.sh`. Running it should
|
|
guide you though the release, although it may require some changes to run on
|
|
configurations different than Greg's machine.
|
|
|
|
Check whether any new Ubuntu versions need to be listed in this script
|
|
before running it.
|
|
|
|
You should run it from `master`.
|
|
|
|
## Homebrew
|
|
|
|
* Go to https://github.com/Homebrew/homebrew-core/edit/master/Formula/libmaxminddb.rb
|
|
* Edit the file to update the url and sha256. You can get the sha256 for the
|
|
tarball with the `sha256sum` command line utility.
|
|
* Make a commit with the summary `libmaxminddb <VERSION>`
|
|
* Submit a PR with the changes you just made.
|
|
|
|
# Prerequisites for releasing
|
|
|
|
* Required packages (Ubuntu Artful): vim git-core dput build-essential
|
|
autoconf automake libtool git-buildpackage libfile-slurp-perl pandoc
|
|
dirmngr libfile-slurp-tiny-perl libdatetime-perl debhelper dh-autoreconf
|
|
libipc-run3-perl libtest-output-perl devscripts
|
|
* Install [hub](https://github.com/github/hub/releases). (Using `./install`
|
|
from the tarball is fine)
|
|
* GitHub ssh key (e.g. in `~/.ssh/id_rsa`)
|
|
* Git config (e.g. `~/.gitconfig`)
|
|
* Import your GPG secret key (or create one if you don't have a suitable
|
|
one)
|
|
* `gpg --import /path/to/key`
|
|
* `gpg --edit-key KEYID` and trust it ultimately
|
|
* Ensure it shows with `gpg --list-secret-keys`
|
|
* You need to be invited to the launchpad.net MaxMind organization on your
|
|
launchpad.net account.
|
|
* You need your GPG key listed on your launchpad.net account
|
|
* You can add it in the web interface. It wants the output of
|
|
`gpg --fingerprint`.
|
|
* Part of the instructions involve having your key published on the
|
|
Ubuntu keyserver:
|
|
`gpg --keyserver keyserver.ubuntu.com --send-keys KEYID`
|
|
* You'll get an email with an encrypted payload that you need to decrypt
|
|
and follow the link to confirm it.
|
|
* Ensure `dch` knows your name and email. Refer to its man page for how to
|
|
tell it this. One way is to set the `DEBFULLNAME` and `DEBEMAIL`
|
|
environment variables. These should match your GPG key's name and email
|
|
exactly. This is what gets used in the Debian changelog as well as
|
|
defines what GPG key to use.
|