GitHub Action
Port Sender
Port is an open internal developer portal. The portal contains valuable data about standards and compliance (in the form of scorecards or initiatives) about software catalog entities, such as the production readiness (scorecard) of a microservice (an entity).
This action will allow you to automatically send reports and reminders with regard to initiatives or scorecards, letting managers and developers know what standards need to be met that are relevant to them.
Find your Port credentials
To find your Port API credentials go to Port, hover on the 3 dots button at the top right corner, select Credentials and then you will be able to view and copy your CLIENT_ID
and CLIENT_SECRET
:
Setting up a slack webhook Head to your Slack apps page and create a new app (or select one of your existing apps). Then, go to the Incoming Webhooks page and create a new webhook, specifying the target channel on your server where messages that are sent to the slack webhook will be transferred.
Copy the webhook URL, you will use it soon to set up your GitHub action.
Action to send a scorecard report to a Slack channel about the current state and progress in a scorecard.
Input | Description | Required | Default |
---|---|---|---|
port_client_id |
Port Client ID | true | |
port_client_secret |
Port Client Secret | true | |
port_region |
Port Region to use, if not provided will use the default region of Port | false | eu |
slack_webhook_url |
Slack Webhook URL | true | |
blueprint |
Blueprint identifier | true | |
scorecard |
Scorecard identifier | true | |
operation_kind |
Message kind to send, to send Scorecard Report, pass - scorecard_report |
true | |
filter_rule |
The rule filter to apply on the data queried from Port | false |
This action will send a scorecard report to a Slack channel about the current state and progress in a scorecard.
You can modify the schedule to run the report on a daily/weekly/monthly basis. For more information about scheduling, refer to the GitHub Actions documentation.
name: Scheduled Scorecards Report
on:
schedule:
## run every day at 9am
- cron: '0 9 * * *'
workflow_dispatch:
jobs:
generate-scorecard-report:
runs-on: ubuntu-latest
steps:
- name: Generate Scorecard Report
uses: port-labs/[email protected]
with:
message_kind: scorecard_report
port_client_id: ${{ secrets.PORT_CLIENT_ID }}
port_client_secret: ${{ secrets.PORT_CLIENT_SECRET }}
slack_webhook_url: ${{ secrets.SLACK_WEBHOOK_URL }}
blueprint: app
scorecard: productionReadiness
A call to action to remind the team that some of their services didn't reach Gold level for specific scorecard.
Input | Description | Required | Default |
---|---|---|---|
port_client_id |
Port Client ID | true | |
port_client_secret |
Port Client Secret | true | |
port_region |
Port Region to use, if not provided will use the default region of Port | false | eu |
slack_webhook_url |
Slack Webhook URL | true | |
blueprint |
Blueprint identifier | true | |
scorecard |
Scorecard identifier | true | |
operation_kind |
Opetation kind to perform, to send Scorecard Reminder, pass - scorecard_reminder |
true | |
filter_rule |
The rule filter to apply on the data queried from Port | false |
This example will send a scheduled reminder to a Slack channel about all the services that didn't reach the Gold level in the productionReadiness
scorecard for the Backend Team.
You can modify the schedule to run the reminder on a daily/weekly/monthly basis. For more information about scheduling, refer to the GitHub Actions documentation. You can also modify the filter rule to filter the services, ideally you would want to filter by team, so that each team will get a reminder about their services.
name: Generate Scorecards Reminders
on:
schedule:
## run every day at 9am
- cron: '0 9 * * *'
workflow_dispatch:
jobs:
generate-scorecards-reminders:
runs-on: ubuntu-latest
steps:
- name: Generate Scorecards Reminders
uses: port-labs/[email protected]
with:
message_kind: scorecard_reminder
port_client_id: ${{ secrets.PORT_CLIENT_ID }}
port_client_secret: ${{ secrets.PORT_CLIENT_SECRET }}
slack_webhook_url: ${{ secrets.SLACK_WEBHOOK_URL }}
blueprint: app
scorecard: productionReadiness
filter_rule: '{"property": "$team","operator": "containsAny","value": ["Backend Team"]}'
A call to action to sync Jira issues (create/reopen/resolve) with scorecards and rules.
For every scorecard level that is not completed, a Jira task will be created and Subtasks for the level rules.
Generated Scorecard task for the bronze level:
Generated subtasks for the task:
Input | Description | Required | Default |
---|---|---|---|
port_client_id |
Port Client ID | true | |
port_client_secret |
Port Client Secret | true | |
port_region |
Port Region to use, if not provided will use the default region of Port | false | eu |
slack_webhook_url |
Slack Webhook URL | true | |
blueprint |
Blueprint identifier | true | |
scorecard |
Scorecard identifier | true | |
opeation_kind |
Message kind to send, to send Scorecard Reminder, pass - scorecard_reminder |
true | |
filter_rule |
The rule filter to apply on the data queried from Port | false | |
jira_project_id |
The project id in Jira for tasks updating | true | |
jira_api_endpoint |
The URL of your Jira organization | true | |
jira_token |
The Jira API token for using Jira's REST API. | true | |
jira_email |
The Jira email of the user account for using Jira's REST API. | true | |
jira_resolve_transition_id |
The Jira transition ID used for resolving issues. If not inserted will use the default transition for the "Done" status. | false | |
jira_reopen_transition_id |
The Jira transition ID used for resolving issues. If not inserted will use the default transition for the "To Do" status. | false |
This example will create a Jira task for every service in every level that are not completed in the productionReadiness
scorecard for the Backend Team.
For every rule in the scorecard that is not completed, a subtask under the relevant task in Jira will be created.
Once the scorecard is completed, the tasks and subtasks will be resolved (passed to Done status).
You can modify the schedule to run the reminder on a daily/weekly/monthly basis. For more information about scheduling, refer to the GitHub Actions documentation.
You can also modify the filter rule to filter the services, ideally you would want to filter by team, so that each team will get a reminder about their services.
name: Sync Jira Issues with Scorecard Initiatives
on:
schedule:
## run every day at 9am
- cron: '0 9 * * *'
workflow_dispatch:
jobs:
sync-jira-issues:
runs-on: ubuntu-latest
steps:
- name: Sync Jira Issues
uses: port-labs/[email protected]
with:
operation_kind: ticket_handler
port_client_id: ${{ secrets.PORT_CLIENT_ID }}
port_client_secret: ${{ secrets.PORT_CLIENT_SECRET }}
blueprint: app
scorecard: productionReadiness
filter_rule: '{"property": "$team","operator": "containsAny","value": ["Backend Team"]}'
jira_api_endpoint: https://example.atlassian.net
jira_email: [email protected]
jira_project_id: EXAMPLE
jira_token: ${{ secrets.JIRA_TOKEN }}
target_kind: jira
You can find more examples in the examples folder