Turn the bug report template into a form with more context (#1401)
I believe this helps us focus on relatively more important issues like critical bug reports and highly-requested feature requests. Co-authored-by: Callum Tait <15716903+toast-gear@users.noreply.github.com>
This commit is contained in:
		
							parent
							
								
									55369bf846
								
							
						
					
					
						commit
						dbcb67967f
					
				|  | @ -1,107 +0,0 @@ | ||||||
| --- |  | ||||||
| name: Bug report |  | ||||||
| about: Create a report to help us improve |  | ||||||
| title: '' |  | ||||||
| assignees: '' |  | ||||||
| 
 |  | ||||||
| --- |  | ||||||
| 
 |  | ||||||
| **Describe the bug** |  | ||||||
| A clear and concise description of what the bug is. |  | ||||||
| 
 |  | ||||||
| **Environment (please complete the following information):** |  | ||||||
|  - Controller Version [e.g. 0.18.2, or git commit ID] (Refer to semver-like release tags for controller versions. Any release tags prefixed with `actions-runner-controller-` are for chart releases) |  | ||||||
|  - Deployment Method [e.g. Helm and Kustomize ] |  | ||||||
|  - Helm Chart Version [e.g. 0.11.0, if applicable] |  | ||||||
| 
 |  | ||||||
| **Checks** |  | ||||||
| 
 |  | ||||||
| - [ ] This isn't a question or user support case (For Q&A and community support, go to [Discussions](https://github.com/actions-runner-controller/actions-runner-controller/discussions). It might also be a good idea to contract with any of contributors and maintainers if your business is so critical and therefore you need priority support |  | ||||||
| - [ ] I've read [releasenotes](https://github.com/actions-runner-controller/actions-runner-controller/tree/master/docs/releasenotes) before submitting this issue and I'm sure it's not due to any recently-introduced backward-incompatible changes |  | ||||||
| - [ ] My actions-runner-controller version (v0.x.y) does support the feature |  | ||||||
| - [ ] I've already upgraded ARC to the latest and it didn't fix the issue |  | ||||||
| 
 |  | ||||||
| **To Reproduce** |  | ||||||
| Steps to reproduce the behavior: |  | ||||||
| 1. Go to '...' |  | ||||||
| 2. Click on '....' |  | ||||||
| 3. Scroll down to '....' |  | ||||||
| 4. See error |  | ||||||
| 
 |  | ||||||
| **Expected behavior** |  | ||||||
| A clear and concise description of what you expected to happen. |  | ||||||
| 
 |  | ||||||
| **Resource definitions** |  | ||||||
| Add a copy of your resourec definition (RunnerDeployment or RunnerSet, and HorizontalRunnerAutoscaler. If RunnerSet, also include the StorageClass being used) |  | ||||||
| 
 |  | ||||||
| ```yaml |  | ||||||
| apiVersion: actions.summerwind.dev/v1alpha1 |  | ||||||
| kind: RunnerDeployment |  | ||||||
| metadata: |  | ||||||
|   name: example |  | ||||||
| spec: |  | ||||||
|   #snip |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| ```yaml |  | ||||||
| apiVersion: actions.summerwind.dev/v1alpha1 |  | ||||||
| kind: RunnerSet |  | ||||||
| metadata: |  | ||||||
|   name: example |  | ||||||
|  spec: |  | ||||||
|    #snip |  | ||||||
| --- |  | ||||||
| apiVersion: storage.k8s.io/v1 |  | ||||||
| kind: StorageClass |  | ||||||
| metadata: |  | ||||||
|   name: example |  | ||||||
| provisioner: ... |  | ||||||
| reclaimPolicy: ... |  | ||||||
| volumeBindingMode: ... |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| ```yaml |  | ||||||
| apiVersion: actions.summerwind.dev/v1alpha1 |  | ||||||
| kind: HorizontalRunnerAutoscaler |  | ||||||
| metadata: |  | ||||||
|   name: |  | ||||||
| spec: |  | ||||||
|   #snip |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| **Logs**: |  | ||||||
| Include logs from `actions-runner-controller`'s controller-manager pod and runner pods. |  | ||||||
| 
 |  | ||||||
| To grab controller logs, run: |  | ||||||
| 
 |  | ||||||
| ```console |  | ||||||
| # Set NS according to your setup |  | ||||||
| $ NS=actions-runner-system |  | ||||||
| 
 |  | ||||||
| $ kubectl -n $NS get po |  | ||||||
| # Grab the pod name and set it to $POD_NAME |  | ||||||
| 
 |  | ||||||
| $ kubectl -n $NS $POD_NAME > arc.log |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| upload it to e.g. https://gist.github.com/ and paste the link to it here. |  | ||||||
| 
 |  | ||||||
| To grab the runner pod logs, run: |  | ||||||
| 
 |  | ||||||
| ```console |  | ||||||
| # Set NS according to your setup. It should match your RunnerDeployment's metadata.namespace. |  | ||||||
| $ NS=default |  | ||||||
| 
 |  | ||||||
| $ kubectl -n $NS get po |  | ||||||
| # Grab the name of the problematic runner pod and set it to $POD_NAME |  | ||||||
| 
 |  | ||||||
| $ kubectl -n $NS $POD_NAME > runnerpod.log |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| upload it to e.g. https://gist.github.com/ and paste the link to it here. |  | ||||||
| 
 |  | ||||||
| **Screenshots** |  | ||||||
| If applicable, add screenshots to help explain your problem. |  | ||||||
| 
 |  | ||||||
| **Additional context** |  | ||||||
| Add any other context about the problem here. |  | ||||||
|  | @ -0,0 +1,160 @@ | ||||||
|  | name: Bug Report | ||||||
|  | description: File a bug report | ||||||
|  | title: "Bug" | ||||||
|  | labels: ["bug"] | ||||||
|  | body: | ||||||
|  | - type: input | ||||||
|  |   id: controller-version | ||||||
|  |   attributes: | ||||||
|  |     label: Controller Version | ||||||
|  |     description: Refer to semver-like release tags for controller versions. Any release tags prefixed with `actions-runner-controller-` are for chart releases | ||||||
|  |     placeholder: ex. 0.18.2 or git commit ID | ||||||
|  |   validations: | ||||||
|  |     required: true | ||||||
|  | - type: input | ||||||
|  |   id: chart-version | ||||||
|  |   attributes: | ||||||
|  |     label: Helm Chart Version | ||||||
|  |     description: Run `helm list` and see what's shown under CHART VERSION. Any release tags prefixed with `actions-runner-controller-` are for chart releases | ||||||
|  |     placeholder: ex. 0.11.0 | ||||||
|  | - type: dropdown | ||||||
|  |   id: deployment-method | ||||||
|  |   attributes: | ||||||
|  |     label: Deployment Method | ||||||
|  |     description: Which deployment method did you use to install ARC? | ||||||
|  |     options: | ||||||
|  |       - Helm | ||||||
|  |       - Kustomize | ||||||
|  |       - ArgoCD | ||||||
|  |       - Other | ||||||
|  |   validations: | ||||||
|  |     required: true | ||||||
|  | - type: checkboxes | ||||||
|  |   id: checks | ||||||
|  |   attributes: | ||||||
|  |     label: Checks | ||||||
|  |     description: Please check the boxes below before submitting | ||||||
|  |     options: | ||||||
|  |     - label: This isn't a question or user support case (For Q&A and community support, go to [Discussions](https://github.com/actions-runner-controller/actions-runner-controller/discussions). It might also be a good idea to contract with any of contributors and maintainers if your business is so critical and therefore you need priority support | ||||||
|  |       required: true | ||||||
|  |     - label: I've read [releasenotes](https://github.com/actions-runner-controller/actions-runner-controller/tree/master/docs/releasenotes) before submitting this issue and I'm sure it's not due to any recently-introduced backward-incompatible changes | ||||||
|  |       required: true | ||||||
|  |     - label: My actions-runner-controller version (v0.x.y) does support the feature | ||||||
|  |       required: true | ||||||
|  |     - label: I've already upgraded ARC to the latest and it didn't fix the issue | ||||||
|  |       required: true | ||||||
|  | - type: textarea | ||||||
|  |   id: resource-definitions | ||||||
|  |   attributes: | ||||||
|  |     label: Resource Definitions | ||||||
|  |     description: "Add copy(s) of your resource definition(s) (RunnerDeployment or RunnerSet, and HorizontalRunnerAutoscaler. If RunnerSet, also include the StorageClass being used)" | ||||||
|  |     render: yaml | ||||||
|  |     placeholder: | | ||||||
|  |       apiVersion: actions.summerwind.dev/v1alpha1 | ||||||
|  |       kind: RunnerDeployment | ||||||
|  |       metadata: | ||||||
|  |         name: example | ||||||
|  |       spec: | ||||||
|  |         #snip | ||||||
|  |       --- | ||||||
|  |       apiVersion: actions.summerwind.dev/v1alpha1 | ||||||
|  |       kind: RunnerSet | ||||||
|  |       metadata: | ||||||
|  |         name: example | ||||||
|  |       spec: | ||||||
|  |         #snip | ||||||
|  |       --- | ||||||
|  |       apiVersion: storage.k8s.io/v1 | ||||||
|  |       kind: StorageClass | ||||||
|  |       metadata: | ||||||
|  |         name: example | ||||||
|  |       provisioner: ... | ||||||
|  |       reclaimPolicy: ... | ||||||
|  |       volumeBindingMode: ... | ||||||
|  |       --- | ||||||
|  |       apiVersion: actions.summerwind.dev/v1alpha1 | ||||||
|  |       kind: HorizontalRunnerAutoscaler | ||||||
|  |       metadata: | ||||||
|  |         name: | ||||||
|  |       spec: | ||||||
|  |         #snip | ||||||
|  |   validations: | ||||||
|  |     required: true | ||||||
|  | - type: textarea | ||||||
|  |   id: reproduction-steps | ||||||
|  |   attributes: | ||||||
|  |     label: To Reproduce | ||||||
|  |     description: "Steps to reproduce the behavior" | ||||||
|  |     render: markdown | ||||||
|  |     placeholder: | | ||||||
|  |       1. Go to '...' | ||||||
|  |       2. Click on '....' | ||||||
|  |       3. Scroll down to '....' | ||||||
|  |       4. See error | ||||||
|  |   validations: | ||||||
|  |     required: true | ||||||
|  | - type: textarea | ||||||
|  |   id: actual-behavior | ||||||
|  |   attributes: | ||||||
|  |     label: Describe the bug | ||||||
|  |     description: Also tell us, what did happen? | ||||||
|  |     placeholder: A clear and concise description of what happened. | ||||||
|  |   validations: | ||||||
|  |     required: true | ||||||
|  | - type: textarea | ||||||
|  |   id: expected-behavior | ||||||
|  |   attributes: | ||||||
|  |     label: Describe the expected behavior | ||||||
|  |     description: Also tell us, what did you expect to happen? | ||||||
|  |     placeholder: A clear and concise description of what the expected behavior is. | ||||||
|  |   validations: | ||||||
|  |     required: true | ||||||
|  | - type: textarea | ||||||
|  |   id: controller-logs | ||||||
|  |   attributes: | ||||||
|  |     label: Controller Logs | ||||||
|  |     description: "Include logs from `actions-runner-controller`'s controller-manager pod" | ||||||
|  |     render: shell | ||||||
|  |     placeholder: | | ||||||
|  |       To grab controller logs: | ||||||
|  | 
 | ||||||
|  |       # Set NS according to your setup | ||||||
|  |       NS=actions-runner-system | ||||||
|  | 
 | ||||||
|  |       # Grab the pod name and set it to $POD_NAME | ||||||
|  |       kubectl -n $NS get po | ||||||
|  | 
 | ||||||
|  |       kubectl -n $NS logs $POD_NAME > arc.log | ||||||
|  | 
 | ||||||
|  |       Upload it to e.g. https://gist.github.com/ and paste the link to it here. | ||||||
|  |   validations: | ||||||
|  |     required: true | ||||||
|  | - type: textarea | ||||||
|  |   id: runner-pod-logs | ||||||
|  |   attributes: | ||||||
|  |     label: Runner Pod Logs | ||||||
|  |     description: "Include logs from runner pod(s)" | ||||||
|  |     render: shell | ||||||
|  |     placeholder: | | ||||||
|  |       To grab the runner pod logs: | ||||||
|  | 
 | ||||||
|  |       # Set NS according to your setup. It should match your RunnerDeployment's metadata.namespace. | ||||||
|  |       NS=default | ||||||
|  | 
 | ||||||
|  |       # Grab the name of the problematic runner pod and set it to $POD_NAME | ||||||
|  |       kubectl -n $NS get po | ||||||
|  | 
 | ||||||
|  |       kubectl -n $NS logs $POD_NAME -c runner > runnerpod_runner.log | ||||||
|  |       kubectl -n $NS logs $POD_NAME -c docker > runnerpod_docker.log | ||||||
|  | 
 | ||||||
|  |       Upload it to e.g. https://gist.github.com/ and paste the link to it here. | ||||||
|  |   validations: | ||||||
|  |     required: true | ||||||
|  | - type: textarea | ||||||
|  |   id: additional-context | ||||||
|  |   attributes: | ||||||
|  |     label: Additional Context | ||||||
|  |     description: | | ||||||
|  |       Add any other context about the problem here. | ||||||
|  | 
 | ||||||
|  |       Tip: You can attach images or log files by clicking this area to highlight it and then dragging files in. | ||||||
|  | @ -0,0 +1,15 @@ | ||||||
|  | # Blank issues are mainly for maintainers who are known to write complete issue descriptions without need to following a form | ||||||
|  | blank_issues_enabled: true | ||||||
|  | contact_links: | ||||||
|  | - name: Sponsor ARC Maintainers | ||||||
|  |   about: If your business relies on the continued maintainance of actions-runner-controller, please consider sponsoring the project and the maintainers. | ||||||
|  |   url: https://github.com/actions-runner-controller/actions-runner-controller/tree/master/CODEOWNERS | ||||||
|  | - name: Ideas and Feature Requests | ||||||
|  |   about: Wanna request a feature? Create a discussion and collect :+1:s first. | ||||||
|  |   url: https://github.com/actions-runner-controller/actions-runner-controller/discussions/new?category=ideas | ||||||
|  | - name: Questions and User Support | ||||||
|  |   about: Need support using ARC? We use Discussions as the place to provide community support. | ||||||
|  |   url: https://github.com/actions-runner-controller/actions-runner-controller/discussions/new?category=questions | ||||||
|  | - name: Need Paid Support? | ||||||
|  |   about: Consider contracting with any of the actions-runner-controller maintainers and contributors. | ||||||
|  |   url: https://github.com/actions-runner-controller/actions-runner-controller/tree/master/CODEOWNERS | ||||||
|  | @ -0,0 +1,2 @@ | ||||||
|  | # actions-runner-controller maintainers | ||||||
|  | * @mumoshu @toast-gear | ||||||
		Loading…
	
		Reference in New Issue