Headbanger is a music recommendation and discovery platform.
Use the bin/setup script or run the following steps manually.
Set up the PostgreSQL database:
rails db:setup
Initialize database seeds:
rails database:seed # Production and development seeds
rails database:seed:production # Production seeds
rails database:seed:development # Development seeds
Run database migrations:
rails db:migrate
Use the bin/update script to update your development environment dependencies.
Useful resources:
To debug the server component in your IDE, start the debug instead of the app container, and connect to localhost:1234.
Seed the test database before running the test suite:
rails database:seed:production RAILS_ENV=test
Run the test suite:
rspec
By default, an NGINX caching proxy is configured on http://web:81/.
The app server uses this as default endpoint for queries.
If you wish to override this, set at least the MA_ENDPOINT environment variable.
MA_USER and MA_PASSWORD can be set if the endpoint is protected with HTTP Basic Authentication.
By default, the app server will use the same database settings as the main PostgreSQL server.
If you wish to override this, set the MB_HOST, MB_USER, MB_PASSWORD and MB_DATABASE environment variables.
An SSH forwarding container is also available, if the database resides on another host.
In this case, set the MB_SSH_HOST environment variable and connect to the musicbrainz container.
SSH authentication is handled by the host's SSH agent running on SSH_AUTH_SOCK.
Rebuild the search indices:
rails pg_search:multisearch:rebuild[Artist]
rails pg_search:multisearch:rebuild[Group]
rails pg_search:multisearch:rebuild[Release]Github secrets for continuous integration:
-
APP_EMAIL -
MA_ENDPOINT(optional) -
MA_ENDPOINT_USER(optional) -
MA_ENDPOINT_PASSWORD(optional)
Github secrets for release:
SENTRY_AUTH_TOKEN(needed for uploading source maps to Sentry)DOCKER_TOKEN(needed for Github Container Registry)
Github secrets for continuous deployment (process):
-
DOCKER_TOKEN(needed for Github Container Registry) -
SWARM_SSH_HOST(user@host) -
SWARM_SSH_KEY(private key of user, RSA format, convert OpenSSH keys by runningssh-keygen -p -m PEM -f ~/.ssh/id_rsa) -
SWARM_SSH_HOST_KEY(public key of host)
Github secrets for continuous deployment (application):
-
SECRET_KEY_BASE -
APP_EMAIL -
APP_HOST -
PG_HOST(optional) -
PG_USER(optional) -
PG_PASSWORD(optional) -
PG_DATABASE(optional) -
RAILS_APP_SENTRY_DSN -
VUE_APP_SENTRY_DSN -
VUE_APP_INSTANCE -
VUE_APP_CACHE_DOMAIN -
SMTP_HOST -
SMTP_PORT -
SMTP_DOMAIN -
SMTP_USERNAME -
SMTP_PASSWORD -
SMTP_FROM -
SMTP_TO(for deployment notifications) -
MA_ENDPOINT(optional) -
MA_ENDPOINT_USER(optional) -
MA_ENDPOINT_PASSWORD(optional) -
MB_HOST(optional) -
MB_USER(optional) -
MB_PASSWORD(optional) -
MB_DATABASE(optional) -
HB_DATA_EXPIRES_IN(optional) -
HB_SYNC_LIMIT(optional) -
HB_SYNC_INTERVAL(optional) -
HB_RECOMMENDATION_LIMIT(optional)
Update the changelog and bump the version using the bin/version tool.
Execute bin/version --help to see all parameters.
Create a tag for the version and push it to Github.
A Docker image will automatically be built and pushed to the registry.
bin/version version 1.0.0
git add lib/headbanger/version.rb web/package.json
git commit -m "Bump version to v1.0.0"
git tag v1.0.0
git push origin master
git push origin v1.0.0Initial deployment
# SSH into the server
ssh [email protected]
# Create a user
useradd -G ssh -G docker -m -s /bin/bash headbanger
su - headbanger
# Create SSH keypair
myserver$ mkdir ~/.ssh/
ssh-keygen -f ~/.ssh/headbanger-deployment-key -b 4096 -C "Headbanger deployment key"
cp ~/.ssh/headbanger-deployment-key.pub ~/.ssh/authorized_keys
# Initialize the database
docker exec -ti `docker ps -q name=postgres_postgres` psql -U postgres -c "CREATE ROLE headbanger WITH ENCRYPTED PASSWORD 'headbanger' LOGIN;"
docker exec -ti `docker ps -q name=postgres_postgres` psql -U postgres -c "CREATE DATABASE headbanger OWNER headbanger;"
# Logout, but don't forget to copy over the private key, and the host public key to your local machine
logout
logout
# Generate TLS client certificates for NGINX
openssl req -nodes -new -x509 -keyout ops/client.key -out ops/client.pemAdditionally, set DEPLOY_SSH_KEY, DEPLOY_SSH_HOST and DEPLOY_SSH_USER as Github Actions secrets.
Subsequent deployments
Ensure the images have been built and are available in the container registry.
Apply your changes in ops/docker-compose.yml.
Update the production tag to the correct commit and push it to Github
The file will automatically be deployed, and the containers recreated.
nano ops/docker-compose.yml
git add ops/docker-compose.yml
git commit -m "Update images to latest version"
git tag -f production
git push origin master && git push -f origin productionSee LICENSE.md.
![dependabot-preview[bot] avatar](https://avatars.githubusercontent.com/in/2141?v=4 "dependabot-preview[bot]")
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent