juansecu/github-discord-updater repository overview

The purpose of this application is to retrieve GitHub updates than Discord webhooks cannot process successfully due to the expected format of the payload from Discord.

⁠Requirements

• Node.js⁠ - Version 20.x

• Discord Webhook URL

• Environment variables:

  Variable	Type	Description	Required	Default	Example
  HTTPS_CERT_FILEPATH	String	The file path of the HTTPS certificate file	No	None	/path/to/cert.pem
  HTTPS_KEY_FILEPATH	String	The file path of the HTTPS key file	No	None	/path/to/key.pem
  NODE_ENV	String	The environment where the application is running	No	None	development
  PORT	Number	The port where the HTTP server will be running	No	3000	9020
  PUBLIC_HOST_ADDRESS	String	The public address where the application is running	Yes	None	example.com
  SHOULD_USE_HTTPS	Boolean	Whether the application should use HTTPS	No	false	true

  Note:

  • The NODE_ENV variable is used to determine the environment where the application is running. It is highly recommended to set it to production when deploying the application to a production environment.

⁠Supported GitHub Events

• gollum

⁠Running

In order to run the application using Docker⁠, you must have Docker installed on your machine.

For running the application with Docker, you will need to mount both the SSL cert and key files using Docker volumes and map port 3000 to your host machine.

⁠Docker CLI

• Windows

  > docker run -dp 8080:8080 \
      -v <path\to\ssl-cert>:${HTTPS_CERT_FILEPATH} \
      -v <path\to\ssl-key>:${HTTPS_KEY_FILEPATH} \
      --env-file <path\to\env\file> \
      --name <container-name> \
      juansecu/github-discord-updater:v<version number>
  

  Copy

• MacOS/Linux

  $ docker run -dp 3000:3000 \
      --env-file <path/to/env/file> \
      --name <container-name> \
      juansecu/github-discord-updater:v<version number>
  

  Copy

⁠Docker Compose

For running the application with Docker Compose, you can use the Docker Compose file⁠ provided in this repository for development and production.

After configuring the environment variables, you can run the application using the following command:

• Docker Compose v1

$ docker-compose up -d

• Docker Compose v2

$ docker compose up -d

⁠How to Use

For learning how to use the application, you can check the API documentation by visiting the path /api-docs on the application's URL.

Once you understand how to use the application, you can start using it to retrieve GitHub updates by adding the application's URL as a webhook to the GitHub repository you want to retrieve updates from.