Skip to content

Latest commit

 

History

History
118 lines (85 loc) · 3.79 KB

CONTRIBUTING.md

File metadata and controls

118 lines (85 loc) · 3.79 KB
Raw

Contributing Instructions

Pull the project.

git clone https://github.com/pganalyze/collector

Make sure you have gcc installed and in your $PATH: parts of the collector's dependencies rely on cgo and will be skipped if a C compiler is not available, causing the collector build to fail.

Setup

The dependencies are stored in the vendor folder, so no installation is needed.

Setup for updating dependencies

go install github.com/goware/modvendor@latest

Then, make sure Go package executables are on your $PATH. For Homebrew on macOS that is ~/go/bin. If it's working, which modvendor should return the path that modvendor is installed at.

make vendor

Updating dependencies

go get github.com/shirou/gopsutil@latest # updates the version requirement
make vendor                              # updates the vendored code

Compiling and running tests

To compile the collector and helper binaries:

make build

After building the collector you can find the binary in the repository folder:

./pganalyze-collector --help

To run the unit tests:

make test

To run the integration tests:

make integration_test

Note the integration tests require Docker, and will take a while to run through.

Build the Helm Docs

The Helm chart README.md file is generated by helm-docs. To ensure that the documentation remains up-to-date, regenerate the README.md file using the helm-docs command whenever you make changes to the Helm chart or prior to making a new release.

You can either install helm-docs locally, or run using Docker:

$ docker run --rm --volume "$(pwd):/helm-docs" -u "$(id -u)" jnorwood/helm-docs:latest
time="2024-04-26T02:01:07Z" level=info msg="Found Chart directories [contrib/helm/pganalyze-collector]"
time="2024-04-26T02:01:07Z" level=info msg="Generating README Documentation for chart contrib/helm/pganalyze-collector

Release

  1. Create a PR to update the version numbers and CHANGELOG.md
  2. Once PR is merged, create a new tag git tag v0.x.y, then push it git push origin v0.x.y
  3. Once a new tag is pushed, GitHub Action Release will be kicked and create a new release (this will take about 2 hours, due to the package build and test)
  4. Modify the newly created release's description to match to CHANGELOG.md
  5. Release docker images using make docker_release (this requires access to the Quay.io push key, as well as "docker buildx" with QEMU emulation support, see below)
  6. Sign and release packages using make -C packages repo (this requires access to the Keybase GPG key)

To run step 5 from an Ubuntu 22.04 VM, do the following:

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin

# Add support for ARM emulation
sudo apt update
sudo apt install qemu-user-static binfmt-support make

# Get these credentials from Quay.io
sudo docker login -u="REPLACE_ME" -p="REPLACE_ME" quay.io

git clone https://github.com/pganalyze/collector.git
cd collector
sudo make docker_release