Repository navigation
Expand file tree
/
Copy pathgit2planner.example.yml
More file actions
81 lines (68 loc) · 3.13 KB
/
Copy pathgit2planner.example.yml
File metadata and controls
81 lines (68 loc) · 3.13 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
# git2planner configuration
# Documentation: https://github.com/francescodifilippo/git2planner/blob/main/docs/configuration.md
#
# ${NAME} is replaced by the environment variable NAME, ${NAME:-value} adds a default.
graph:
# Microsoft Entra ID app registration (see docs/azure-setup.md).
# tenant_id, client_id and client_secret default to $AZURE_TENANT_ID,
# $AZURE_CLIENT_ID and $AZURE_CLIENT_SECRET.
# tenant_id: 00000000-0000-0000-0000-000000000000
# client_id: 00000000-0000-0000-0000-000000000000
# auth: auto | client_secret | federated | github_oidc | device_code | access_token
auth: auto
state:
# Remembers which task belongs to which issue and what was synced last.
path: .git2planner/state.json
# Settings shared by every sync (each sync may override any of them).
defaults:
# git-to-planner: issues -> tasks | planner-to-git: tasks -> issues | both
direction: git-to-planner
# Which side wins when the same field changed in Git and in Planner: git | planner
conflicts: git
filters:
state: open # issues that get a new task: open | closed | all
labels: [] # only issues carrying all of these labels
exclude_labels: []
include_pull_requests: false
buckets:
strategy: fixed # fixed | label | milestone | board (project board columns)
default: To do
closed: Done # closed issues move here (remove to keep their bucket)
# mapping: # label, milestone or board column -> bucket
# bug: Bugs
# board: # board strategy: GitHub Projects, Gitea 28+, GitLab boards
# project: 1 # project number (GitHub), id or title (Gitea), board (GitLab)
categories:
mode: auto # auto: each label gets a Planner label | explicit | off
exclude: [priority/urgent, priority/high, priority/low]
# mapping: # label -> Planner label name or slot (category1..category25)
# bug: Bug
# security: category2
assignees:
use_git_email: true # match the public e-mail of the Git user
# email_domain: contoso.com # fallback: <git login>@contoso.com
# mapping: # Git login -> UPN, e-mail or Entra object id
# octocat: mona@contoso.com
priority:
mapping:
priority/urgent: urgent
priority/high: important
priority/low: low
default: medium
attachments:
mode: link # link | upload (to the group's SharePoint library) | off
task:
title_template: "#{number} {title}"
checklist: true # Markdown task lists become Planner checklists
on_close: complete # complete | delete | ignore
planner_to_git:
fields: [state, title, assignees, labels, bucket, due_date, checklist]
create_issues: false # open issues for tasks created in Planner
syncs:
- name: my-project
source:
provider: github
repository: owner/repo
# url: https://github.example.com # GitHub Enterprise Server only
# token: read from $GITHUB_TOKEN when omitted
plan_id: REPLACE-WITH-PLAN-ID # run `git2planner plans --group <group id>`