The application integrating GitLab with Telegram.

The application listens for GitLab webhooks and calls the Telegram Bot API.

• Comment on merge request
• Comment on code snippet
• Merge request events
• Pipeline events ('failed' event only)

1. Plan the endpoint for the application to run.
2. Setup GitLab webhooks and obtain a GitLab secret token. Use the following url as a webhook target: <your_endpoint>/gitlab_hook, e.g. https://my-hook-endpoint.com/gitlab_hook
3. Setup a Telegram bot and obtain a Bot token
4. Setup a Telegram channel to which your bot would post messages
5. Configure and deploy the app, see the Configuration reference section below

Use any of the standard ways to provide the app configuration:

• appsettigns.json
• appsettings.{environment}.json
• environment variables
• command line arguments

There are several ways to configure a .NET Core application

1. appsettings.json file - normally contains the most of the configuration.
2. appsettings.{environment}.json file - may be used to make some environment-dependent configuration overrides. The environment name normally comes from the ASPNETCORE_ENVIRONEMNT environment variable or from an --environment command line arg. By-default the environment name is Production, so the filename would be the appsettings.production.json.
3. Environment variables. Every setting from the appsettings.json may be overriden by an environment variable, having a name, same to the setting name in appsettings.json. The : symbol in a variable name is used as a hierarchy level separator. E.g. configuration setting TGram > Connection > Timeout may be overriden by an environemnt variable TGRAM:CONNECTION:TIMEOUT.
4. Command line arguments. Every setting from the appsettings.json may be overriden by a command-line key. The : symbol in a key name is used as a hierarchy-level separator. E.g. configuration setting TGram > Connection > Timeout may be overriden by a --tgram:connection:timeout parameter.

1. Ensure you have the runtime of a compatible version installed. At the moment the application was developed, the 2.2.x version of the runtime was current. Pay attention you don't need the whole SDK to run the app - a bare runtime is enough.
2. run dotnet TGramWeb.dll, optionally providing command-line args. e.g: dotnet TGramWeb.dll --urls http://localhost:9000 --environment azure

A set of addresses the app would be listening at. A semicolon ; may be used as a separator for multiple addresses. E.g. http://localhost:5000;https://localhost:5001

Determines the application environment. The default value is Production

A secure token you obtain when configuring a gitlab web hook.

Address of the telegram API. Normally https://api.telegram.org

Telegram bot token you obtain when creating a bot.

Telegram channel name. E.g. @mytgramchannel

Connection timeout when trying to send a message to telegram.

Number of attempts to send a message to telegram before giving up.

An interval between telegram call attempts.

A localhost address used to communicate between the web server and internal message handlers.

Serilog standard configuration. See here.