{"id":22796281,"url":"https://github.com/makerxstudio/shared-config","last_synced_at":"2026-04-08T05:01:11.036Z","repository":{"id":62408113,"uuid":"538762632","full_name":"MakerXStudio/shared-config","owner":"MakerXStudio","description":"A collection of MakerX reusable workflows and configs.","archived":false,"fork":false,"pushed_at":"2026-04-02T09:12:48.000Z","size":298,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":11,"default_branch":"main","last_synced_at":"2026-04-02T12:19:45.350Z","etag":null,"topics":["automation","devops","github-actions","infrastructure","internal","oss"],"latest_commit_sha":null,"homepage":"","language":null,"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/MakerXStudio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-09-20T01:32:49.000Z","updated_at":"2026-04-02T09:12:31.000Z","dependencies_parsed_at":"2023-02-03T05:16:08.744Z","dependency_job_id":"0e6810b8-4a6a-4566-87f2-3a120e07b100","html_url":"https://github.com/MakerXStudio/shared-config","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/MakerXStudio/shared-config","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MakerXStudio%2Fshared-config","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MakerXStudio%2Fshared-config/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MakerXStudio%2Fshared-config/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MakerXStudio%2Fshared-config/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MakerXStudio","download_url":"https://codeload.github.com/MakerXStudio/shared-config/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MakerXStudio%2Fshared-config/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31540826,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"online","status_checked_at":"2026-04-08T02:00:06.127Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["automation","devops","github-actions","infrastructure","internal","oss"],"created_at":"2024-12-12T05:11:47.506Z","updated_at":"2026-04-08T05:01:10.996Z","avatar_url":"https://github.com/MakerXStudio.png","language":null,"readme":"# MakerX Shared Config\nA collection of MakerX reusable workflows and configs.\n\n## Versioning and Releases\n\nThis repository uses [Release Please](https://github.com/googleapis/release-please) to automate releases based on [Conventional Commits](https://www.conventionalcommits.org/).\n\n### Available Tags\n\nWhen referencing workflows or actions from this repository, you can pin to specific versions using the following tag formats:\n\n| Tag | Example | Description |\n|-----|---------|-------------|\n| Full version | `v1.2.3` | Pin to an exact release (recommended for production) |\n| Minor version | `v1.2` | Automatically receive patch updates |\n| Major version | `v1` | Automatically receive minor and patch updates |\n| Latest | `latest` | Always points to the most recent release |\n\n### Usage Examples\n\n```yaml\n# Pin to exact version (most stable)\nuses: MakerXStudio/shared-config/.github/workflows/example.yml@v1.2.3\n\n# Pin to minor version (receives patch updates)\nuses: MakerXStudio/shared-config/.github/workflows/example.yml@v1.2\n\n# Pin to major version (receives minor and patch updates)\nuses: MakerXStudio/shared-config/.github/workflows/example.yml@v1\n\n# Always use latest (not recommended for production)\nuses: MakerXStudio/shared-config/.github/workflows/example.yml@latest\n```\n\n### Contributing\n\nWhen contributing to this repository, use [Conventional Commits](https://www.conventionalcommits.org/) to ensure proper versioning:\n\n- `feat: description` - New feature (bumps minor version)\n- `fix: description` - Bug fix (bumps patch version)\n- `feat!: description` or `BREAKING CHANGE:` in body - Breaking change (bumps major version)\n\nRelease Please will automatically create a release PR when changes are pushed to `main`. Merging this PR triggers the release.\n\nFor more information, see the [Release Please documentation](https://github.com/googleapis/release-please#readme).\n\n## GitHub - Zendesk integration\nThe zendesk github integration consist of 3 github actions.\n- [github_zendesk_issue_labelled.yml](.github/workflows/github_zendesk_issue_labelled.yml)\n- [github_zendesk_issue_commented.yml](.github/workflows/github_zendesk_issue_commented.yml)\n- [github_zendesk_issue_closed.yml](.github/workflows/github_zendesk_issue_closed.yml)\n\n### Issue labelled\nOnce an issue is assigned a specified label, it is sent to Zendesk,\ncreating (or using) the user `\u003cGithub UserName\u003e` with email `\u003cGithub UserName\u003e@users.noreply.github.com`.\nThis mail adress format is also used by github when a user sets the privacy option that the mail should be hidden.\nOnce the ticket got created a comment to the issue will be added to inform the user about the tech support contact.\n\n### Issue commented\nEvery comment on an issue gets send to zendesk. It will look up the connected ticket and author and attaches the comment to the ticket.\n\n### Issue closed\nWhen an issue is closed, it is marked as solved in Zendesk.\n\n### Integration\nThe workflows need to be added to each repository that we want to sync issues to Zendesk. However, to avoid repeat code, they can also be reused via [Calling a reusable workflow](https://docs.github.com/en/actions/learn-github-actions/reusing-workflows#calling-a-reusable-workflow). Samples can be found [here](samples/github-zendesk-integration-workflows/).\n\n### Limitations\nThere are known limitation of GitHub - Zendesk integration:\n- Markdown comments aren't supported due to an issue with Zendesk API.\n- When an issue is created, existing comments aren't synced to Zendesk.\n- Comment updates aren't synced to Zendesk.\n- Removing issue label from GitHub doesn't have an affect, the corresponding Zendesk ticket is still need to be handled manually.\n- The GitHub actions don't have retry logic, if they failed, the data won't be synced.\n\n## Zendesk - GitHub integration\nZendesk - GitHub integration is done via webhook and Zendesk events. Zendesk events will trigger GitHub workflows of a GitHub repository (let's call it the entry point). From this entry point, it works out the target repository for dispatching workflows. Currently, there are:\n- [zendesk_github_ticket_commented.yml](.github/workflows/zendesk_github_ticket_commented.yml)\n- [zendesk_github_ticket_solved.yml](.github/workflows/zendesk_github_ticket_solved.yml)\n\n### Setup Zendesk webhook\nYou can find the Postman collection for Zendesk API [here](postman/Zendesk%20API/). Import the collection and the global variables to your local postman. There are some variables to set:\n- zendesk-tenant-name: Zendesk tenant name (it also is called subdomain), can be found in the URL. For example, for https://my-subdomain.zendesk.com/, it's my-subdomain\n- zendesk-auth-token: Zendesk auth token. See https://support.zendesk.com/hc/en-us/articles/115000510267-How-can-I-authenticate-API-requests-#heading2\n- zendesk-webhook-id: Zendesk webhook Id, we will set that later\n- github-owner: GitHub repository owner\n- github-repo: The repository which Zendesk will trigger the workflow from\n- github-pat: GitHub personal access token, it needs to have repository permission `contents:write` to the entry point repository\n\nSteps:\n- Run `Create webhook` API to create the Zendesk webhook. Remember to take note of the response `id` and set the `zendesk-webhook-id` variable.\n- Run `Create trigger - ticket solved` API\n- Run `Create trigger - ticket commented` API\n\n### Integration\nFrom GitHub side, there are:\n- [zendesk_github_add_comment.yml](.github/workflows/zendesk_github_add_comment.yml)\n- [zendesk_github_close_issue.yml](.github/workflows/zendesk_github_close_issue.yml)\n\nThey will be invoked by `zendesk_github_ticket_commented` and `zendesk_github_ticket_solved` respectively. They need to be added to each repository that we want to sync comments and statuses from Zendesk. However, to avoid repeat code, they can also be reused via [Calling a reusable workflow](https://docs.github.com/en/actions/learn-github-actions/reusing-workflows#calling-a-reusable-workflow). Samples can be found [here](samples/zendesk-github-integration-workflows/).\n\nZendesk - GitHub integration needs `GH_ZENDESK_INVOKE_WORKFLOW_TOKEN` secrets to invoke the workflows. It's a personal access token, the only requirement is to have permission `contents:write` to any repository that we want to sync from Zendesk.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakerxstudio%2Fshared-config","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmakerxstudio%2Fshared-config","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakerxstudio%2Fshared-config/lists"}