{"id":14984647,"url":"https://github.com/bsramin/slack-jenkins-bot","last_synced_at":"2025-04-10T21:22:04.401Z","repository":{"id":48113474,"uuid":"348877213","full_name":"bsramin/slack-jenkins-bot","owner":"bsramin","description":"A small utility to be able to command Jenkins via Slack","archived":false,"fork":false,"pushed_at":"2022-08-02T23:03:08.000Z","size":3763,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-24T18:52:25.648Z","etag":null,"topics":["jenkins","jenkins-ci","slack","slack-api","slack-bot","slackbot","trigger"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bsramin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-03-17T23:08:51.000Z","updated_at":"2022-08-02T23:01:44.000Z","dependencies_parsed_at":"2022-08-12T18:50:44.407Z","dependency_job_id":null,"html_url":"https://github.com/bsramin/slack-jenkins-bot","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsramin%2Fslack-jenkins-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsramin%2Fslack-jenkins-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsramin%2Fslack-jenkins-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsramin%2Fslack-jenkins-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bsramin","download_url":"https://codeload.github.com/bsramin/slack-jenkins-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248299024,"owners_count":21080449,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jenkins","jenkins-ci","slack","slack-api","slack-bot","slackbot","trigger"],"created_at":"2024-09-24T14:09:27.618Z","updated_at":"2025-04-10T21:22:04.376Z","avatar_url":"https://github.com/bsramin.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SLACK \u003c-\u003e JENKINS BOT\n\n[![License](http://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/bsramin/slack-jenkins-bot/blob/main/LICENSE.txt)\n\nThis bot allows you to safely and _effectively_ run jobs on jenkins _directly from Slack_, also receiving end-of-execution notifications.\nThrough permissions it is possible to configure, for each single job, who has the right to execute it from slack and at any time it is possible to check the last jobs performed.\n\n## USAGE\n\nAfter the [installation](documentation/install.md), from Slack simply run the commands.\n\nEg.\n\n  `/do job1`\n\n  `/do job2 param1=value1`\n\n  `/do job3 param1=value1 param2=value2`\n\n  `/requests` (the view the latest requests)\n\n### Jenkins Response\n\nIf your `request` needs to show on slack an output generated by the Jenkins job, you just have to generate an [artifact](documentation/slackResponse.txt) which contains this output.\nUse this snippet:\n\n```groovy\nslackfields = '\"title1\",\"content1\",\"false\"\\n\"title2\",\"content2\",\"false\"'\nwriteFile(file: 'slackResponse.txt', text: slackfields)\narchiveArtifacts artifacts: 'slackResponse.txt', onlyIfSuccessful: true\n```\n\nThe last element of `slackfields` (boolean) identifies the full-width (true) or half-width (false) block on slack in order to stack two of them\n\n## SETUP\n\nFollow the [setup instruction](documentation/install.md)\n\n## FAQ\n\n### How do I access Jenkins server from behind a router?\n\nYou can use [ngrok](https://ngrok.com/) or [webhookrelay](https://webhookrelay.com/)\n\n# LICENSE\n\nThe MIT License (MIT)\n\nCopyright (c) 2021 Ramin Banihashemi\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbsramin%2Fslack-jenkins-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbsramin%2Fslack-jenkins-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbsramin%2Fslack-jenkins-bot/lists"}