The Hitchhiker's Guide to the Azure Galaxyand the Joy of Open Source Documentation

1. Welcome to the

2. The Hitchhiker's Guide to the Azure Galaxy
and the Joy of Open Source Documentation
Nicolò Carandini [MVP]
n.carandini@outlook.com
@TPCWare #GABRome18
#GlobalAzure

3. Conoscere Azure
E’ un mondo così vasto
che nessuno può dire di conoscerlo appieno.
Nella tumultuosa realizzazione di ogni sua parte,
la documentazione è stata realizzata a più mani e
necessariamente in modo non organico.
Recentemente è stato fatto un grande lavoro di
riorganizzazione del materiale, anche didattico, per
favorire e facilitare l’apprendimento.

4. Cos’è Azure
• Una infrastruttura hardware
• Un insieme di servizi (IAAS, PAAS, SAAS)
• Un insieme di strumenti e SDK

5. Azure Global Infrastructure

6. Azure Global Infrastructure
Aree globali
• L’infrastruttura di Azure è composta da 50 regioni e offre i suoi servizi a 140
paesi nel mondo.
Aree geografiche di Azure
• Assicurano il rispetto dei requisiti di residenza, sovranità, conformità e
resilienza entro limiti geografici.
Disponibilità dei prodotti in base all’area
• Alcuni prodotti sono disponibili ovunque, altri dipendono dalle aree.
Per saperne di più sull’infrastruttura globale di Azure:
https://azure.microsoft.com/it-it/global-infrastructure

7. Tipologia di servizi: IaaS, PaaS e SaaS

8. Azure Products

9. Azure Tools & SDK
• Linguaggi & Framework
• Interfaccia della riga di comando
• Strumenti ed estensioni

10. Linguaggi & Framework
Librerie di Azure per .NET
Librerie di Azure per Java
Ruby SDK
Librerie di Azure per Node.js
Librerie di Azure per Python
Go SDK

11. Command Line Interface (CLI)
Azure CLI 2.0
PowerShell
Azure CLI for Linux and Mac

12. Strumenti ed estensioni
Strumenti di Visual Studio per Azure
Strumenti SQL
SDK e strumenti di Service Fabric
Storage Explorer
Strumenti di PowerShell per Visual Studio
Python Tools
Strumenti di Docker

13. Fonti di apprendimento
• Sito di Azure
www.azure.com (-> azure.microsoft.com)
• Documentazione di Azure su MS Docs
docs.microsoft.com/en-us/azure/
docs.microsoft.com/it-it/azure/
• Infographics
azure.microsoft.com/en-us/resources/infographics

14. Altre fonti di apprendimento
• Azure Blog
azure.microsoft.com/en-us/blog
• Azure solution architectures
azure.microsoft.com/en-us/solutions/architecture/
• Azure Essentials
www.microsoft.com/en-us/azureessentials

15. Git e GitHub
• Git Beginner's Guide for Dummies
backlog.com/git-tutorial
• TryGit
try.github.io
• GitHub Learning Lab
lab.github.com

16. Open Software Documentation
Tutta la documentazione di Microsoft Docs (docs.microsoft.com) è open
source e sta su GitHub.
Chiunque può contribuire, basta fare click sulla matita in alto a destra,
presente in ogni pagina:

17. Il contenuto della pagina su GitHub

18. Contribuire al miglioramento della documentazione
Una volta arrivati su GitHub è possibile modificare il contenuto della
documentazione (che è tutta scritta in formato Markdown*) e fare
una Pull Request, nello stesso modo in cui si fa per qualsiasi
progetto open source su GitHub (vedi la guida di GitHub).
Verrà avviata una discussione sul proprio contributo e se accettato
verrà fatto il merge col progetto principale e il nostro lavoro apparirà
nelle pagine di documentazione ufficiale con il nostro avatar
nell’elenco dei contributori alla pagina.
* Vedi: it.wikipedia.org/wiki/Markdown