{"id":17653899,"url":"https://github.com/traefik/aloba","last_synced_at":"2025-05-07T09:13:43.203Z","repository":{"id":52201371,"uuid":"99519008","full_name":"traefik/aloba","owner":"traefik","description":"🤖 [Myrmica Aloba 🐜] Bot: Add labels and milestone on pull requests and issues","archived":false,"fork":false,"pushed_at":"2023-03-16T13:33:27.000Z","size":159,"stargazers_count":18,"open_issues_count":0,"forks_count":3,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-05-07T09:13:31.164Z","etag":null,"topics":["github","github-actions","github-bot","issues","labels","milestones","pull-requests"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/traefik.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-08-06T23:27:41.000Z","updated_at":"2023-10-03T13:52:02.000Z","dependencies_parsed_at":"2022-09-05T07:10:58.569Z","dependency_job_id":"fcd1fd00-42b8-441f-8904-337858c669a7","html_url":"https://github.com/traefik/aloba","commit_stats":null,"previous_names":["containous/aloba"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/traefik%2Faloba","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/traefik%2Faloba/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/traefik%2Faloba/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/traefik%2Faloba/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/traefik","download_url":"https://codeload.github.com/traefik/aloba/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252847514,"owners_count":21813457,"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":["github","github-actions","github-bot","issues","labels","milestones","pull-requests"],"created_at":"2024-10-23T12:07:27.327Z","updated_at":"2025-05-07T09:13:43.180Z","avatar_url":"https://github.com/traefik.png","language":"Go","readme":"# Myrmica Aloba: Add labels and milestone on pull requests and issues.\n\n[![Release](https://img.shields.io/github/release/traefik/aloba.svg?style=flat)](https://github.com/traefik/aloba/releases/latest)\n[![Build Status](https://github.com/traefik/aloba/workflows/Main/badge.svg?branch=master)](https://github.com/traefik/aloba/actions)\n[![Docker Image Version (latest semver)](https://img.shields.io/docker/v/traefik/aloba?label=Docker%20Image)](https://hub.docker.com/r/traefik/aloba/builds/)\n\n## Overview\n\nAvailable Commands:\n- `action`: GitHub Action (Add labels and milestone on pull requests and issues.)\n- `label`: Add labels and milestone on pull requests and issues.\n- `report`: Create a report and publish on Slack.\n- `version`: Display the version.\n\n## Manage GitHub labels.\n\n- on new issue: adds the label `status/0-needs-triage`\n- on new pull request:\n    - adds the label `status/0-needs-triage`\n    - add labels based on [rules](#rules).\n    - adds a milestone (if a milestone matches the based branch of the PR).\n    - adds a label related to the size of the pull request.\n\n### Command `action`\n\n```yaml\nGitHub Action\n\nUsage: action [--flag=flag_argument] [-f[flag_argument]] ...     set flag_argument to flag(s)\n   or: action [--flag[=true|false| ]] [-f[true|false| ]] ...     set true/false to boolean flag(s)\n\nFlags:\n    --debug   Debug mode.                        (default \"false\")\n    --dry-run Dry run mode.                      (default \"true\")\n-h, --help    Print Help (this message) and exit \n```\n\n- `GITHUB_TOKEN`: Github Token.\n- `.github/aloba-rules.toml`: the rules to apply.\n\n#### Examples:\n\n```hcl\nworkflow \"Aloba: Issues\" {\n  on = \"issues\"\n  resolves = [\"issue-labels\"]\n}\n\naction \"issue-labels\" {\n  uses = \"docker://traefik/aloba\"\n  secrets = [\"GITHUB_TOKEN\"]\n  args = \"action --dry-run=false\"\n}\n\nworkflow \"Aloba: Pull Requests\" {\n  on = \"pull_request\"\n  resolves = [\"pull-request-labels\"]\n}\n\naction \"pull-request-labels\" {\n  uses = \"docker://traefik/aloba\"\n  secrets = [\"GITHUB_TOKEN\"]\n  args = \"action --dry-run=false\"\n}\n```\n\n### Command `label`\n\n```yaml\nAdd labels and milestone on pull requests and issues.\n\nUsage: label [--flag=flag_argument] [-f[flag_argument]] ...     set flag_argument to flag(s)\n   or: label [--flag[=true|false| ]] [-f[true|false| ]] ...     set true/false to boolean flag(s)\n\nFlags:\n    --debug            Debug mode.                        (default \"false\")\n    --dry-run          Dry run mode.                      (default \"true\")\n    --github           GitHub options.                    (default \"true\")\n-o, --github.owner     Repository owner.\n-r, --github.repo-name Repository name.\n    --github.token     GitHub token.\n    --rules-path       Path to the rule file.             (default \"./rules.toml\")\n    --web-hook         Run as WebHook.                    (default \"true\")\n    --web-hook.port    WebHook port.                      (default \"80\")\n    --web-hook.secret  WebHook secret.\n-h, --help             Print Help (this message) and exit\n```\n\n- `GITHUB_TOKEN`: Github Token.\n- `WEBHOOK_SECRET`: Github WebHook Secret.\n\n#### Examples:\n\n```shell\naloba label -o traefik -r traefik --web-hook --github.token=\"xxxxxxxxxx\"\n```\n\n### Rules\n\n```toml\n[[Rules]]\n  Label = \"area/vegetable\"\n  Regex = \"(?i).*(tomate|carotte).*\"\n\n[[Rules]]\n  Label = \"area/cheese\"\n  Regex = \"cheese/.*\"\n\n[[Rules]]\n  Label = \"area/infrastructure\"\n  Regex = \"(?i)(\\\\.github|script/).*\"\n\n[Limits]\n  [Limits.Small]\n    SumLimit = 150\n    DiffLimit = 70\n    FilesLimit = 20\n  [Limits.Medium]\n    SumLimit = 400\n    DiffLimit = 200\n    FilesLimit = 50\n```\n\n## Command `report`\n\n```yaml\nCreate a report and publish on Slack.\n\nUsage: report [--flag=flag_argument] [-f[flag_argument]] ...     set flag_argument to flag(s)\n   or: report [--flag[=true|false| ]] [-f[true|false| ]] ...     set true/false to boolean flag(s)\n\nFlags:\n    --debug            Debug mode.                        (default \"false\")\n    --dry-run          Dry run mode.                      (default \"true\")\n    --github           GitHub options.                    (default \"true\")\n-o, --github.owner     Repository owner.\n-r, --github.repo-name Repository name.\n    --github.token     GitHub token.\n    --slack            Slack options.                     (default \"true\")\n    --slack.bot-icon   Bot icon emoji.                    (default \":captainpr:\")\n    --slack.bot-name   Bot name.                          (default \"CaptainPR\")\n    --slack.channel    Slack channel ID.\n    --slack.token      Slack token.\n-h, --help             Print Help (this message) and exit\n```\n\n- `GITHUB_TOKEN`: Github Token.\n- `SLACK_TOKEN`: Slack Token.\n\n### Examples:\n\n```shell\naloba report -o traefik -r traefik --github.token=\"xxxxxxxxxx\" --slack.token=\"xxxxxxxxxx\" --slack.channel=C0CDT22PJ\n```\n\n## The Mymirca colony\n\n- [Myrmica Lobicornis](https://github.com/traefik/lobicornis) 🐜: Update and merge pull requests.\n- [Myrmica Aloba](https://github.com/traefik/aloba) 🐜: Add labels and milestone on pull requests and issues.\n- [Messor Structor](https://github.com/traefik/structor) 🐜: Manage multiple documentation versions with Mkdocs.\n- [Lasius Mixtus](https://github.com/traefik/mixtus) 🐜: Publish documentation to a GitHub repository from another.\n- [Myrmica Bibikoffi](https://github.com/traefik/bibikoffi) 🐜: Closes stale issues\n- [Chalepoxenus Kutteri](https://github.com/traefik/kutteri) 🐜: Track a GitHub repository and publish on Slack.\n- [Myrmica Gallienii](https://github.com/traefik/gallienii) 🐜: Keep Forks Synchronized\n\n## What does Myrmica Aloba mean?\n\n![Myrmica Aloba](http://www.antwiki.org/wiki/images/8/8c/Myrmica_aloba_H_casent0907652.jpg)\n","funding_links":[],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftraefik%2Faloba","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftraefik%2Faloba","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftraefik%2Faloba/lists"}