Skip to content

Commit b9d28cb

Browse files
BuckWoodyBuckWoody
committed
Updates to Template
1 parent 827bdf8 commit b9d28cb

File tree

7 files changed

+647
-13
lines changed

7 files changed

+647
-13
lines changed

‎README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,7 @@ Find a problem? Spot a bug? [Post an issue here](https://github.com/Microsoft/sq
4040
- [Presentation Materials - *(PowerPoint Decks, etc.)*](https://github.com/Microsoft/sqlworkshops/tree/master/References/README.MD#decks)
4141
- [Example Code](https://github.com/Microsoft/sqlworkshops/tree/master/References/README.MD#code)
4242
- [References and Tools from the Microsoft SQL Team](https://github.com/Microsoft/sqlworkshops/tree/master/References/README.MD#links)
43+
- [The template for these Workshops and Labs is here - free to use](https://github.com/microsoft/sqlworkshops-template)
4344

4445
## Learning how to self-learn
4546

‎WorkshopTemplate/LICENSES/CODE_OF_CONDUCT.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# Microsoft Open Source Code of Conduct
2+
3+
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
4+
5+
Resources:
6+
7+
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
8+
- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
9+
- Contact [[email protected]](mailto:[email protected]) with questions or concerns

‎WorkshopTemplate/LICENSES/LICENSE

Lines changed: 395 additions & 0 deletions
Large diffs are not rendered by default.

‎WorkshopTemplate/LICENSES/LICENSE-CODE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) Microsoft Corporation.
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE

‎WorkshopTemplate/LICENSES/README.md

Lines changed: 138 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,138 @@
1+
![](https://github.com/microsoft/sqlworkshops-k8stobdc/blob/master/graphics/microsoftlogo.png?raw=true)
2+
3+
# Workshop: Kubernetes - From Bare Metal to SQL Server Big Data Clusters
4+
5+
#### <i>A Microsoft Course from the SQL Server team</i>
6+
7+
<p style="border-bottom: 1px solid lightgrey;"></p>
8+
9+
<h2><img style="float: left; margin: 0px 15px 15px 0px;" src="https://github.com/microsoft/sqlworkshops/blob/master/graphics/textbubble.png?raw=true"><b> About this Workshop</b></h2>
10+
11+
Welcome to this Microsoft solutions workshop on *Kubernetes - From Bare Metal to SQL Server Big Data Clusters*. In this workshop, you'll learn about setting up a production-grade SQL Server 2019 big data cluster environment on Kubernetes. Topics covered include: hardware, virtualization, and Kubernetes, with a full deployment of SQL Server's Big Data Cluster on the environment that you will use in the class. You'll then walk through a set of [Jupyter Notebooks](https://jupyter-notebook-beginner-guide.readthedocs.io/en/latest/what_is_jupyter.html) in Microsoft's [Azure Data Studio](https://docs.microsoft.com/en-us/sql/azure-data-studio/what-is?view=sql-server-ver15) tool to run T-SQL, Spark, and Machine Learning workloads on the cluster. You'll also receive valuable resources to learn more and go deeper on Linux, Containers, Kubernetes and SQL Server big data clusters.
12+
13+
The focus of this workshop is to understand the hardware, software, and environment you need to work with [SQL Server 2019's big data clusters](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-overview?view=sql-server-ver15) on a Kubernetes platform.
14+
15+
You'll start by understanding Containers and Kubernetes, moving on to a discussion of the hardware and software environment for Kubernetes, and then to more in-depth Kubernetes concepts. You'll follow-on with the SQL Server 2019 big data clusters architecture, and then how to use the entire system in a practical application, all with a focus on how to extrapolate what you have learned to create other solutions for your organization.
16+
17+
> NOTE: This course is designed to be taught in-person with hardware or virtual environments provided by the instructional team. You will also get details for setting up your own hardware, virtual or Cloud environments for Kubernetes for a workshop backup or if you are not attending in-person.
18+
19+
This [github README.MD file](https://lab.github.com/githubtraining/introduction-to-github) explains how the workshop is laid out, what you will learn, and the technologies you will use in this solution.
20+
21+
(You can view all of the [source files for this workshop on this github site, along with other workshops as well. Open this link in a new tab to find out more.](https://github.com/microsoft/sqlworkshops-k8stobdc))
22+
23+
<p style="border-bottom: 1px solid lightgrey;"></p>
24+
25+
<h2><img style="float: left; margin: 0px 15px 15px 0px;" src="https://github.com/microsoft/sqlworkshops/blob/master/graphics/checkmark.png?raw=true"><b> Learning Objectives</b></h2>
26+
27+
In this workshop you'll learn:
28+
<br>
29+
30+
- How Containers and Kubernetes work and when and where you can use them
31+
- Hardware considerations for setting up a production Kubernetes Cluster on-premises
32+
- Considerations for Virtual and Cloud-based environments for production Kubernetes Cluster
33+
34+
The concepts and skills taught in this workshop form the starting points for:
35+
36+
Solution Architects, to understand how to design an end-to-end solution.
37+
System Administrators, Database Administrators, or Data Engineers, to understand how to put together an end-to-end solution.
38+
39+
<p style="border-bottom: 1px solid lightgrey;"></p>
40+
41+
<h2><img style="float: left; margin: 0px 15px 15px 0px;" src="https://github.com/microsoft/sqlworkshops/blob/master/graphics/building1.png?raw=true"><b> Business Applications of this Workshop</b></h2>
42+
43+
Businesses require stable, secure environments at scale, which work in secure on-premises and in-cloud configurations. Using Kubernetes and Containers allows for manifest-driven DevOps practices, which further streamline IT processes.
44+
45+
<p style="border-bottom: 1px solid lightgrey;"></p>
46+
47+
<h2><img style="float: left; margin: 0px 15px 15px 0px;" src="https://github.com/microsoft/sqlworkshops/blob/master/graphics/listcheck.png?raw=true"><b> Technologies used in this Workshop</b></h2>
48+
49+
The solution includes the following technologies - although you are not limited to these, they form the basis of the workshop. At the end of the workshop you will learn how to extrapolate these components into other solutions. You will cover these at an overview level, with references to much deeper training provided.
50+
51+
<table style="tr:nth-child(even) {background-color: #f2f2f2;}; text-align: left; display: table; border-collapse: collapse; border-spacing: 2px; border-color: gray;">
52+
53+
<tr><th style="background-color: #1b20a1; color: white;">Technology</th> <th style="background-color: #1b20a1; color: white;">Description</th></tr>
54+
55+
<tr><td><i>Linux</i></td><td>The primary operating system used in and by Containers and Kubernetes</td></tr>
56+
<tr><td><i>Containers</i></td><td>The atomic layer of a Kubernetes Cluster</td></tr>
57+
<tr><td><i>Kubernetes</i></td><td>The primary clustering technology for manifest-driven environments</td></tr>
58+
<tr><td>SQL Server Big Data Clusters</td><td>Relational and non-relational data at scale with Spark, HDFS and application deployment capabilities</td></tr>
59+
60+
</table>
61+
62+
<p style="border-bottom: 1px solid lightgrey;"></p>
63+
64+
<h2><img style="float: left; margin: 0px 15px 15px 0px;" src="https://github.com/microsoft/sqlworkshops/blob/master/graphics/owl.png?raw=true"><b> Before Taking this Workshop</b></h2>
65+
66+
There are a few requirements for attending the workshop, listed below:
67+
- You'll need a local system that you are able to install software on. The workshop demonstrations use Microsoft Windows as an operating system and all examples use Windows for the workshop. Optionally, you can use a Microsoft Azure Virtual Machine (VM) to install the software on and work with the solution.
68+
- You must have a Microsoft Azure account with the ability to create assets for the "backup" or self-taught path.
69+
- This workshop expects that you understand computer technologies, networking, the basics of SQL Server, HDFS, Spark, and general use of Hypervisors.
70+
- The **Setup** section below explains the steps you should take prior to coming to the workshop
71+
72+
If you are new to any of these, here are a few references you can complete prior to class:
73+
74+
- [Microsoft SQL Server Administration and Use](https://www.microsoft.com/en-us/learning/course.aspx?cid=OD20764)
75+
- [HDFS](https://data-flair.training/blogs/hadoop-hdfs-tutorial/)
76+
- [Spark](https://www.edx.org/course/implementing-predictive-analytics-with-spark-in-az)
77+
- [Hypervisor Technologies - Hyper-V](https://docs.microsoft.com/en-us/windows-server/virtualization/hyper-v/hyper-v-technology-overview)
78+
or
79+
- [Hypervisor Technologies - VMWare](https://tsmith.co/free-vmware-training/)
80+
81+
<h3><img style="float: left; margin: 0px 15px 15px 0px;" src="https://github.com/microsoft/sqlworkshops/blob/master/graphics/bulletlist.png?raw=true"><b> Setup</b></h3>
82+
83+
<a href="https://github.com/microsoft/sqlworkshops-k8stobdc/blob/master/KubernetesToBDC/00-prerequisites.md" target="_blank">A full pre-requisites document is located here</a>. These instructions should be completed before the workshop starts, since you will not have time to cover these in class. <i>Remember to turn off any Virtual Machines from the Azure Portal when not taking the class so that you do incur charges (shutting down the machine in the VM itself is not sufficient)</i>.
84+
85+
<p style="border-bottom: 1px solid lightgrey;"></p>
86+
87+
<h2><img style="float: left; margin: 0px 15px 15px 0px;" src="https://github.com/microsoft/sqlworkshops/blob/master/graphics/education1.png?raw=true"><b> Workshop Details</b></h2>
88+
89+
This workshop uses Kubernetes to deploy a workload, with a focus on Microsoft SQL Server's big data clusters deployment for advanced analytics over large sets of data and Data Science workloads.
90+
91+
<table style="tr:nth-child(even) {background-color: #f2f2f2;}; text-align: left; display: table; border-collapse: collapse; border-spacing: 5px; border-color: gray;">
92+
93+
<tr><td style="background-color: Cornsilk; color: black; padding: 5px 5px;">Primary Audience:</td><td style="background-color: Cornsilk; color: black; padding: 5px 5px;">Technical processionals tasked with configuring, deploying and managing large-scale clustering systems</td></tr>
94+
<tr><td>Secondary Audience:</td><td> Data professionals tasked with working with data at scale</td></tr>
95+
<tr><td style="background-color: Cornsilk; color: black; padding: 5px 5px;">Level: </td><td style="background-color: Cornsilk; color: black; padding: 5px 5px0;"> 300 </td></tr>
96+
<tr><td>Type:</td><td> In-Person (self-guided possible)</td></tr>
97+
<tr><td style="background-color: Cornsilk; color: black; padding: 5px 5px;">Length: </td><td style="background-color: Cornsilk; color: black; padding: 5px 5px;">8</td></tr>
98+
99+
</table>
100+
101+
<p style="border-bottom: 1px solid lightgrey;"></p>
102+
103+
<h2><img style="float: left; margin: 0px 15px 15px 0px;" src="https://github.com/microsoft/sqlworkshops/blob/master/graphics/pinmap.png?raw=true"><b> Related Workshops</b></h2>
104+
105+
- [50 days from zero to hero with Kubernetes](https://azure.microsoft.com/mediahandler/files/resourcefiles/kubernetes-learning-path/Kubernetes%20Learning%20Path%20version%201.0.pdf)
106+
107+
<p style="border-bottom: 1px solid lightgrey;"></p>
108+
109+
<h2><img style="float: left; margin: 0px 15px 15px 0px;" src="https://github.com/microsoft/sqlworkshops/blob/master/graphics/bookpencil.png?raw=true"><b> Workshop Modules</b></h2>
110+
111+
This is a modular workshop, and in each section, you'll learn concepts, technologies and processes to help you complete the solution.
112+
113+
<table style="tr:nth-child(even) {background-color: #f2f2f2;}; text-align: left; display: table; border-collapse: collapse; border-spacing: 5px; border-color: gray;">
114+
115+
<tr><td style="background-color: AliceBlue; color: black;"><b>Module</b></td><td style="background-color: AliceBlue; color: black;"><b>Topics</b></td></tr>
116+
117+
<tr><td><a href="https://github.com/microsoft/sqlworkshops-k8stobdc/blob/master/KubernetesToBDC/01-introduction.md" target="_blank">01 - An introduction to Linux, Containers and Kubernetes </a></td><td> This module covers Container technologies and how they are different than Virtual Machines. You'll learn about the need for container orchestration using Kubernetes.</td></tr>
118+
<tr><td style="background-color: AliceBlue; color: black;"><a href="https://github.com/microsoft/sqlworkshops-k8stobdc/blob/master/KubernetesToBDC/02-hardware.md" target="_blank">02 - Hardware and Virtualization environment for Kubernetes</a> </td><td td style="background-color: AliceBlue; color: black;"> This module explains how to make a production-grade environment using "bare metal" computer hardware or with a virtualized platform, and most importantly the storage hardware aspects.</td></tr>
119+
<tr><td><a href="https://github.com/microsoft/sqlworkshops-k8stobdc/blob/master/KubernetesToBDC/03-kubernetes.md" target="_blank">03 - Kubernetes Concepts and Implementation</a></td><td> Covers deploying Kubernetes, Kubernetes contexts, cluster troubleshooting and management, services: load balancing versus node ports, understanding storage from a Kubernetes perspective and making your cluster secure.</td></tr>
120+
<tr><td style="background-color: AliceBlue; color: black;"><a href="https://github.com/microsoft/sqlworkshops-k8stobdc/blob/master/KubernetesToBDC/04-bdc.md" target="_blank">04 - SQL Server Big Data Clusters Architecture</a> </td><td td style="background-color: AliceBlue; color: black;"> This module will dig deep into the anatomy of a big data cluster by covering topics that include: the data pool, storage pool, compute pool and cluster control plane, active directory integration, development versus production configurations and the tools required for deploying and managing a big data cluster.</td></tr> <tr><td><a href="https://github.com/microsoft/sqlworkshops-k8stobdc/blob/master/KubernetesToBDC/05-datascience.md" target="_blank">05 - Using the SQL Server big data cluster on Kubernetes for Data Science</a></td><td> Now that your big data cluster is up, it's ready for data science workloads. This Jupyter Notebook and Azure Data Studio based module will cover the use of python and PySpark, T-SQL and the execution of Spark and Machine Learning workloads.</td></tr>
121+
122+
</table>
123+
124+
<p style="border-bottom: 1px solid lightgrey;"></p>
125+
126+
<h2><img style="float: left; margin: 0px 15px 15px 0px;" src="https://github.com/microsoft/sqlworkshops/blob/master/graphics/geopin.png?raw=true"><b> Next Steps</b></h2>
127+
128+
129+
Next, Continue to <a href="https://github.com/microsoft/sqlworkshops-k8stobdc/blob/master/KubernetesToBDC/00-prerequisites.md" target="_blank"><i> Pre-Requisites</i></a>
130+
131+
**Workshop Authors and Contributors**
132+
133+
- [The Microsoft SQL Server Team](http://microsoft.com/sql)
134+
- [Chris Adkin](https://www.linkedin.com/in/wollatondba/), Pure Storage
135+
136+
**Legal Notice**
137+
138+
*Kubernetes and the Kubernetes logo are trademarks or registered trademarks of The Linux Foundation. in the United States and/or other countries. The Linux Foundation and other parties may also have trademark rights in other terms used herein. This Workshop is not certified, accredited, affiliated with, nor endorsed by Kubernetes or The Linux Foundation.*

‎WorkshopTemplate/LICENSES/SECURITY.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
<!-- BEGIN MICROSOFT SECURITY.MD V0.0.3 BLOCK -->
2+
3+
## Security
4+
5+
Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/).
6+
7+
If you believe you have found a security vulnerability in any Microsoft-owned repository that meets Microsoft's [Microsoft's definition of a security vulnerability](https://docs.microsoft.com/en-us/previous-versions/tn-archive/cc751383(v=technet.10)) of a security vulnerability, please report it to us as described below.
8+
9+
## Reporting Security Issues
10+
11+
**Please do not report security vulnerabilities through public GitHub issues.**
12+
13+
Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://msrc.microsoft.com/create-report).
14+
15+
If you prefer to submit without logging in, send email to [[email protected]](mailto:[email protected]). If possible, encrypt your message with our PGP key; please download it from the the [Microsoft Security Response Center PGP Key page](https://www.microsoft.com/en-us/msrc/pgp-key-msrc).
16+
17+
You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://www.microsoft.com/msrc).
18+
19+
Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
20+
21+
* Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
22+
* Full paths of source file(s) related to the manifestation of the issue
23+
* The location of the affected source code (tag/branch/commit or direct URL)
24+
* Any special configuration required to reproduce the issue
25+
* Step-by-step instructions to reproduce the issue
26+
* Proof-of-concept or exploit code (if possible)
27+
* Impact of the issue, including how an attacker might exploit the issue
28+
29+
This information will help us triage your report more quickly.
30+
31+
If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://microsoft.com/msrc/bounty) page for more details about our active programs.
32+
33+
## Preferred Languages
34+
35+
We prefer all communications to be in English.
36+
37+
## Policy
38+
39+
Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://www.microsoft.com/en-us/msrc/cvd).
40+
41+
<!-- END MICROSOFT SECURITY.MD BLOCK -->

0 commit comments

Comments
 (0)