kortov/teamcity-telegram-plugin

TeamCity notifications for Telegram messenger

Fork Telegram Notifier

TeamCity notifications for Telegram messenger

Added support :

• Markdown
• Emoji

Installation

To install plugin download zip archive it and copy it to Teamcity <data directory>/plugins (it is $HOME/.BuildServer/plugins under Linux and C:\ProgramData\JetBrains\TeamCity\plugins under Windows). For more information, take a look at official documentation

Configuration

Plugin adds new section "Telegram Notifier" under profile and administration pages.

Administration page

Enter bot token. What it is? To use telegram plugin you should create telegram bot. It sends messages to subscribers. Firstly find BotFather (case sensitive) bot. Then send /newbot command. Enter name and username of new bot. After that, response should contains line like 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw. It's bot token. More information about creation of bots you can find in Telegram documentation.

Profile page

Telegram bot can't send messages by username or to user who never write to it. So when Teamcity is running send any message to bot. Response should contains you chat id. Add that chat id under profile page.

TODO

1. This sources contains freemarker templates from Teamcity Jabber plugin. Maybe it violates license. Anybody can view and edit this resources. And this is officially supported by Jetbrains. So I hope there is no problem. But in any case I hope I will be able to know it soon. Of course plugin can simply use same templates from jabber config directory directly, but it's strange.
2. Managing build start from Telegram application.
3. Right know I don't understand how to properly test Teamcity plugins.

teamcity-telegram-plugin's Issues

add tests

For a start add tests for bot, but bot should be mockable, there should not be real requests, because the bot is working and tested in according lib.

Testing UI is difficult, maybe add https://github.com/FluentLenium/FluentLenium

Testing plugin api is difficult, don't know how to implement. Look into org.jetbrains.teamcity:tests-support (maybe bump version)
Examples: https://github.com/browserstack/teamcity-plugin/blob/master/browserstack-teamcity-server/src/test/java/com/browserstack/automate/ci/teamcity/AutomateBuildFeatureTest.java

https://github.com/jonnyzzz/TeamCity.Node/blob/master/tests/src/test/java/NVMDownloadTest.java

Add template edit forms

Each message template should be editable. Add default button to restore.

try Testcontainers

Improve bot messages (send chatid only on /getid

these lines reply on every message with chatid

teamcity-telegram-plugin/telegram-plugin-server/src/main/java/com/notononoto/teamcity/telegram/TelegramBotManager.java

Lines 171 to 184 in fcd903a

	private void addUpdatesListener(TelegramBot bot) {
	bot.setUpdatesListener(updates -> {
	for (Update update : updates) {
	Message message = update.message();
	Long chatId = message.chat().id();
	SendMessage msg = new SendMessage(chatId,
	"Hello! Your chat id is '" + chatId + "'.\n" +
	"If you want to receive notifications about Teamcity events " +
	"please add this chat id in your Teamcity settings");
	bot.execute(msg);
	}
	return UpdatesListener.CONFIRMED_UPDATES_ALL;
	});
	}

add /getid method and add instruction to readme about adding this method

or it should look like /help /getid

Add menu to choose markdown ot html

teamcity-telegram-plugin/telegram-plugin-server/src/main/java/com/notononoto/teamcity/telegram/TelegramBotManager.java

Line 89 in fcd903a

bot.execute(new SendMessage(chatId, convertText(m)).parseMode(ParseMode.HTML).disableWebPagePreview(true));

Add docker compose

There is a branch https://github.com/kortov/teamcity-telegram-plugin/tree/add-docker-compose

it's working, but agents have no names, so teamcity backup in files doesn't find agents. Improve it, add doc to readme and write about it to the repo maintainer. Maybe there is a better image without this backups, but I don't know about it

maybe it's possible to load config backup via cmd with some tool