Skip to content

Commit f982fda

Browse files
committed
Fleshed out readme
1 parent 53fe663 commit f982fda

File tree

1 file changed

+19
-5
lines changed

1 file changed

+19
-5
lines changed

content/guided-workshop/README.md

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Modern DevOps with GitHub
22

3+
[DevOps](https://en.wikipedia.org/wiki/DevOps) is a [portmanteau](https://www.merriam-webster.com/dictionary/portmanteau) of **development** and **operations**. At its core is a desire to bring development practices more inline with operations, and operations practices more inline with development. This fosters better communication and collaboration between teams, breaks down barriers, and gives everyone an investment in ensuring customers are delighted by the software we ship.
4+
35
This workshop is built to help guide you through some of the most common DevOps tasks on GitHub. You'll explore:
46

57
- Managing projects with [GitHub Issues](https://github.com/features/issues)
@@ -8,6 +10,13 @@ This workshop is built to help guide you through some of the most common DevOps
810
- Securing the development pipeline with [GitHub Advanced Security](https://github.com/features/security)
911
- Automating provisioning and deployment with [GitHub Actions](https://github.com/features/actions)
1012

13+
## Prerequisites
14+
15+
This workshop assumes you are familiar with:
16+
17+
- development, however strong coding skills are not required (solution files are provided).
18+
- the cloud, and how resources can be hosted by different providers.
19+
1120
## Required resources
1221

1322
To complete this workshop, you will need the following:
@@ -17,16 +26,16 @@ To complete this workshop, you will need the following:
1726

1827
### Cloud consumption
1928

20-
This workshop does use both GitHub and Azure cloud services. Below is the information you will need about potential costs:
29+
This workshop does use both GitHub and (optionally) Azure cloud services. Below is the information you will need about potential costs:
2130

22-
- GitHub Advanced Security and GitHub Actions are free for public repositories.
31+
- The GitHub Security and GitHub Actions features used during this workshop are at levels which are free for public repositories.
2332
- When using GitHub Codespaces, you have 60 free core hours available which will be more than sufficient for most learners.
24-
- GitHub Copilot does require a subscription, however a [free trial for GitHub Copilot](https://docs.github.com/en/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot#about-billing-for-github-copilot) is available.
25-
- If you choose to deploy to Azure (the last two exercises), there is a cost of around $6US. This amount is covered by creating a new [Azure account](https://azure.microsoft.com/en-us/free/).
33+
- GitHub Copilot does require a subscription, however a [free trial for GitHub Copilot](https://docs.github.com/en/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot#about-billing-for-github-copilot) is available. The coding exercise does not require the use of GitHub Copilot.
34+
- If you choose to deploy to Azure (the last two exercises), there is a cost of around $6 US. This amount is covered by creating a new [Azure account](https://azure.microsoft.com/en-us/free/).
2635

2736
## Getting started
2837

29-
Ready to get started? Let's go! The workshop scenario imagines you as a developer volunteering your time for a pet adoption center. You will work through the process of creating a development environment, creating code, enabling security, automating processes, and finally deploying the project.
38+
Ready to get started? Let's go! The workshop scenario imagines you as a developer volunteering your time for a pet adoption center. You will work through the process of creating a development environment, creating code, enabling security, automating processes, and optionally deploying the project.
3039

3140
0. [Setup your environment](exercises/0-setup.md) for the workshop
3241
1. [Enable Code Scanning](exercises/1-code-scanning.md) to ensure new code is secure
@@ -35,5 +44,10 @@ Ready to get started? Let's go! The workshop scenario imagines you as a develope
3544
4. [Implement testing](exercises/4-testing.md) to supplement continuous integration
3645
5. [Add a new feature](exercises/5-coding.md) to implement the feature
3746
6. [Use the GitHub flow](exercises/6-github-flow.md) to incorporate changes
47+
48+
If you wish, you can also close out your DevOps learning journey by deploying to the cloud. For purposes of this workshop, Azure is used, however the concepts are applicable to any cloud provider.
49+
50+
> **NOTE:** When deploying to a cloud environment, some charges may be incurred. For this workshop, when deploying to Azure and deleting the resources upon completion of the exercises, the charge should be less than $6 US.
51+
3852
7. [Add automation](exercises/7-automation.md) to create a deployment environment
3953
8. [Deploy your project](exercises/8-deployment.md) to publish your project to the cloud

0 commit comments

Comments
 (0)