Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -0,0 +1,173 @@
---
sidebar_position: 10
---
# Azure DevOps Quick Start Guide

:::info
**Document Creation:** December 15, 2024. **Last Edited:** December 15, 2024. **Authors:** Candice Smith.
**Document Code:** ADO-QUIK-001. **Effective Date:** December 15, 2024. **Expiry Date:** December 15, 2025.
:::

Following an assessment of Jira and Azure we underwent configuration of Azure DevOps. We identified that there are two big risks we can ultimately mitigate with the migration:

- Publishing of all Redback content to our public GitHub repos exposes us to inadvertently publishing sensitive information such as credentials, API Keys, and personal and health information
- Planner not being a comprehensive enough project management tool to handle the dynamic and evolving nature of a Capstone company.
This trimester we focused on creating a minimum viable product which would facilitate initial migration and allow future teams to make iterative improvements to the environment. We created a project space for all teams, sprints for T1 2025 and boards for project management, then migrated all content from Planner to Boards. Wikis and dashboards have been set up where possible and testing of these tools has been conducted.

This guide will give you an overview of how to get started using Azure DevOps in place of Planner boards.

## Current Configuration Progress by Team

- Done CS - Candice Smith Completed
- Done Other - Completed by another team member
- OOS - Out of scope T3 2024
### Project 1

- Done CS - Set up project
- Done CS - Allocated Ben Stephens as admin
- Done CS - Set up Areas – IoT, VR, Web
- Done CS - Added sprints for T1 2025
- Done CS - Set Up Boards columns
- Done CS - Added “perpetual informational planner items” as Wikis
- Done CS - Added VR Team Work Details Handbook into Wiki
- Done CS - Added Welcome Wiki
- Done CS - Planner Migration (add planner tasks as user stories with checklist as tasks)
- Done CS - Embed Boards into Teams for T1 2025 instead of Planner.
- Not Started: GitHub Integration
- Not Started: Set up Dashboard
- Not Started: GitHub to Azure Repos migration
### Project 2

- Done CS - Set up project
- Done CS - Allocated Ben Stephens as admin
- Done CS - Added sprints for T1 2025
- Done CS - Set Up Boards columns
- Done CS - Added Welcome Wiki
- Done CS - Added Closed Tasks
- Done CS - Planner Migration (add planner tasks as user stories with checklist as tasks)
- Done CS - Embed Boards into Teams for T1 2025 instead of Planner.
- Not Started: GitHub Integration
- Not Started: Set up Dashboard
- Not Started: GitHub to Azure Repos migration
### Project 3

- Done CS - Set up project
- Done CS - Allocated Ben Stephens as admin
- Done CS - Added sprints for T1 2025
- Done CS - Set Up Boards columns
- Done CS - Added “perpetual informational planner items” as Wikis
- Done CS - Planner Migration (add planner tasks as user stories with checklist as tasks)
- Done CS - Embed Boards into Teams for T1 2025 instead of Planner.
- Not Started: GitHub Integration
- Not Started: Set up Dashboard
- Not Started: GitHub to Azure Repos migration
### Project 4

- Done CS - Set up project
- Done CS - Allocated Ben Stephens as admin
- Done CS - Added sprints for T1 2025
- Done CS - Set Up Boards columns
- Done CS - Added “perpetual informational planner items” as Wikis
- Done CS - Planner Migration (add planner tasks as user stories with checklist as tasks)
- Done CS - Embed Boards into Teams for T1 2025 instead of Planner.
- Not Started: GitHub Integration
- Not Started: Set up Dashboard
- Not Started: GitHub to Azure Repos migration
### Project 5

- Done CS - Set up project
- Done CS - Allocated Ben Stephens as admin
- Done CS - Added sprints for T1 2025
- Done CS - Set Up Boards columns
- Done CS - Added “perpetual informational planner items” as Wikis
- Done CS - Planner Migration (add planner tasks as user stories with checklist as tasks)
- Done CS - Embed Boards into Teams for T1 2025 instead of Planner.
- Not Started: GitHub Integration
- Not Started: Set up Dashboard
- Not Started: GitHub to Azure Repos migration
### Data Warehouse - Jesse

- Done Other - Set up project
- Done Other - Allocated Ben Stephens as admin
- OOS - Added sprints for T1 2025 – Jesse would prefer no sprints so all items can be seen in a unified task view
- Done CS - Set Up Boards columns
- OOS - Planner Migration (complete - The DW team's planner board is from T2 and can be deleted/wiped. All the required information or tasks that carried over to this trimester have been moved to azure boards.)
- Done CS - Embed Boards into Teams for T1 2025 instead of Planner.
- Not Started: GitHub Integration
- Not Started: Set up Dashboard
- Not Started: GitHub to Azure Repos migration
### Cyber Security - Tristan

- Done Other - Set up project - Done
- Done Other - Allocated Ben Stephens as admin - Done
- Done Other - Added sprints for T1 2025 - Done
- Done CS - Set Up Boards columns
- Codey to complete: Added “perpetual informational planner items” as Wikis
- Codey to complete: Planner Migration (add planner tasks as user stories with checklist as tasks)
- Codey to complete: Embed Boards into Teams for T1 2025 instead of Planner.
- Not Started: GitHub Integration
- Not Started: Set up Dashboard
- Not Started: GitHub to Azure Repos migration
### Web and Mobile Dev

- Done CS - Set up project
- Done CS - Allocated Ben Stephens as admin
- Done CS - Added sprints for T1 2025
- Done CS - Set Up Boards columns
- Done CS - Planner Migration (add planner tasks as user stories with checklist as tasks)
- Done CS - Embed Boards into Teams for T1 2025 instead of Planner.
- Not Started: Set up Dashboard
### Company Leaders

- Done CS - Set up project
- Done CS - Allocated Ben Stephens as admin
- Done CS - Added sprints for T1 2025
- Done CS - Set Up Boards columns
- Done CS – Used Board
## Start of Trimester 1, 2025

### For Mentors and Team Leaders

- Mentors must be assigned to their Project Teams with at least Basic access.
- They must assign at least 1 leader in their team with Basic access.
- View the Welcome Wiki found in “Overview” > “Wiki”.
- Mentors/Student Leaders must consider whether you want 1 unified team, or separate sub-teams.
- Go to:

![](img/Picture1.png)

![](img/Picture2.png)

- Then assign all Redback Operations students to their respective teams with Stakeholder access. Do this by clicking on the team’s name, then when you are in the team view click “Add”:

![](img/Picture3.png)

*If any of the student leaders need to make changes to project teams, they will need to seek approval from their mentor for basic access.

Area paths have been set up, so team members should only see their own boards.

Any perpetual informational tasks housed within the previous planner have been added to the Team Wiki which can be found within the Project space > Overview > Wiki.

### For Team Members

- Once you have been granted Stakeholder access to Azure DevOps login and navigate to your team Wiki. This can be found in the left-hand menu under Overview > Wiki.
- Read the Welcome Wiki understanding that some of this will already have been taken care of by your mentor or team leader.
- Once you have read through the welcome wiki go to Boards in the Boards menu in the left-hand pane. It's a good idea to review what was completed last trimester and any item sitting open or in the backlog. This may give you an idea of the direction that you may want to take your individual contribution in.
### For Everyone

At the start of the trimester once the team have looked over the information from the previous trimester it is a good idea to move any complete items you no longer need to reference into the completed previous trimesters column.

## During T1 2025

Here are some items you may want to consider moving into Azure DevOps in T1 2025, they were considered out of scope in T3 2024:

- Move the OnBoarding process into Azure DevOps.
- Set up Power BI Integration so teaching team can audit activity utilising BI reports
- Set up integration with current GitHub repos so teams can start working natively within Azure DevOps.
- Consider full migration of your team’s GitHub repo into Azure Repos, this will create much better security around our dev pipelines.
## At the end of T1 2025

- You may want to set up sprints for the trimester ahead so they can get started quickly.
- Ensure your board is updated and items are moved through the swim lanes accurately reflecting progress.
- Update Welcome Wiki with any knew information that may be required following your own contribution to Azure DevOps.
- You may even want to update this quick start guide for the next cohort to get started quickly in the platform.
Original file line number Diff line number Diff line change
@@ -0,0 +1,112 @@
---
sidebar_position: 4
sidebar_label: Best Practice & Usage Guidelines
title: Best Practice & Usage Guidelines
description: Azure Boards Design & Usage Guidelines for Redback Operations
---
<div style={{ width: '100%' }}>
<table style={{ width: '100%', borderCollapse: 'collapse' }}>
<thead>
<tr>
<th style={{ width: '20%', textAlign: 'center' }}>Version</th>
<th style={{ width: '20%', textAlign: 'center' }}>Modified By</th>
<th style={{ width: '20%', textAlign: 'center' }}>Approver</th>
<th style={{ width: '20%', textAlign: 'center' }}>Date</th>
<th style={{ width: '20%', textAlign: 'center' }}>Changes made</th>
</tr>
</thead>
<tbody>
<tr>
<td style={{ textAlign: 'center' }}>V1.0</td>
<td style={{ textAlign: 'center' }}>Daniel McAulay</td>
<td style={{ textAlign: 'center' }}>Daniel McAulay</td>
<td style={{ textAlign: 'center' }}>17/09/2024</td>
<td style={{ textAlign: 'center' }}>Document Creation</td>
</tr>
<tr>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
</tr>
<tr>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
</tr>
<tr>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
</tr>
<tr>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
</tr>
</tbody>
</table>
</div>

<div style={{height: '4px', width: '100%', background: '#FFA500', margin: '20px 0'}}></div>

## 6. Best Practices for Using Azure Boards

To ensure the successful implementation and ongoing use of Azure Boards within the Redback Operations Cyber Security Team, it is essential to follow established best practices. These practices will help each team manage their tasks efficiently, maintain clear communication, and ensure that all projects are completed on time and to a high standard.

<div style={{height: '4px', width: '100%', background: '#FFA500', margin: '20px 0'}}></div>

### 6.1 Structuring Work Items

Work items are the building blocks of Azure Boards, representing tasks, user stories, bugs, and other units of work that need to be tracked and managed. Properly structuring these work items is crucial for maintaining organization and clarity.

![Work Items](/img/azure-boards-images/6-1-image.png)

<div style={{height: '4px', width: '100%', background: '#FFA500', margin: '20px 0'}}></div>

### 6.2 Task Assignment and Management

Efficient task assignment ensures that work is distributed evenly across the team and that each task is handled by the most qualified team member. Proper management of these tasks is essential for maintaining momentum and avoiding bottlenecks.

![Task Assignments](/img/azure-boards-images/6-2-image.png)

<div style={{height: '4px', width: '100%', background: '#FFA500', margin: '20px 0'}}></div>

### 6.3 Using Boards and Views Effectively

Boards in Azure Boards provide a visual representation of the team's workflow, making it easy to track the progress of tasks and identify any bottlenecks. Configuring these boards to reflect the team's processes is essential for efficient management.

![Boards and Views](/img/azure-boards-images/6-3-image.png)

<div style={{height: '4px', width: '100%', background: '#FFA500', margin: '20px 0'}}></div>

### 6.4 Managing Backlogs

The backlog is a key component of Azure Boards, representing a prioritized list of work items that need to be addressed. Effective backlog management ensures that the most important tasks are completed first and that the team is always working on the highest-value activities.

![Backlogs](/img/azure-boards-images/6-4-image.png)

<div style={{height: '4px', width: '100%', background: '#FFA500', margin: '20px 0'}}></div>

### 6.5 Sprint Planning and Execution

Sprints are time-boxed periods during which specific tasks are completed. Effective sprint planning and execution ensure that the team is focused on achieving clear goals and that progress is made consistently.

![Sprint Planning](/img/azure-boards-images/6-5-image.png)

<div style={{height: '4px', width: '100%', background: '#FFA500', margin: '20px 0'}}></div>

### 6.6 Utilizing Queries and Dashboards

Queries and dashboards in Azure Boards provide tools for monitoring team performance, tracking key metrics, and gaining insights into project progress. Proper use of these tools ensures that the team can make informed decisions and identify areas for improvement.

![Queries and Dashboards](/img/azure-boards-images/6-6-image.png)

<div style={{height: '4px', width: '100%', background: '#FFA500', margin: '20px 0'}}></div>
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
---
sidebar_position: 9
sidebar_label: Conclusion
title: Conclusion
description: Azure Boards Design & Usage Guidelines for Redback Operations
---
<div style={{ width: '100%' }}>
<table style={{ width: '100%', borderCollapse: 'collapse' }}>
<thead>
<tr>
<th style={{ width: '20%', textAlign: 'center' }}>Version</th>
<th style={{ width: '20%', textAlign: 'center' }}>Modified By</th>
<th style={{ width: '20%', textAlign: 'center' }}>Approver</th>
<th style={{ width: '20%', textAlign: 'center' }}>Date</th>
<th style={{ width: '20%', textAlign: 'center' }}>Changes made</th>
</tr>
</thead>
<tbody>
<tr>
<td style={{ textAlign: 'center' }}>V1.0</td>
<td style={{ textAlign: 'center' }}>Daniel McAulay</td>
<td style={{ textAlign: 'center' }}>Daniel McAulay</td>
<td style={{ textAlign: 'center' }}>17/09/2024</td>
<td style={{ textAlign: 'center' }}>Document Creation</td>
</tr>
<tr>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
</tr>
<tr>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
</tr>
<tr>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
</tr>
<tr>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
<td style={{ textAlign: 'center' }}></td>
</tr>
</tbody>
</table>
</div>

<div style={{height: '4px', width: '100%', background: '#FFA500', margin: '20px 0'}}></div>

## 9. Conclusion

The implementation of Azure Boards within the Redback Operations Cyber Security Team represents a critical step in optimizing project management, enhancing collaboration, and improving task visibility across the organization. By configuring Azure Boards to meet the specific needs of each sub-team, this solution provides a tailored platform for managing workflows, tracking progress, and ensuring alignment with the company\'s broader cybersecurity goals.

With features like custom boards, sprints, work item templates, and integrations with essential tools such as GitHub, SonarQube, Nagios, and SIEM systems, Azure Boards empowers each team to efficiently manage their tasks, streamline their workflows, and automate critical processes. The platform\'s ability to track incidents, code reviews, compliance audits, and infrastructure maintenance ensures that all aspects of Redback Operations\' cyber security efforts are properly managed and aligned with organizational priorities.

By integrating best practices in task management, reporting, and sprint execution, this solution is expected to lead to increased efficiency, reduced operational risk, and improved collaboration between teams. The successful deployment of this design ensures that the Redback's Cyber Security Team is equipped to handle its responsibilities while maintaining the flexibility to evolve alongside the organization's needs.

<div style={{height: '4px', width: '100%', background: '#FFA500', margin: '20px 0'}}></div>
Loading
Loading