Skip to content

Commit c4d743a

Browse files
author
Hovsep
authored
Update README.md for Release 1.3 (#29)
* Update README.md for Release 1.3 * Added release link to #More Info section * Migration notes update.
1 parent a1ca094 commit c4d743a

File tree

2 files changed

+29
-52
lines changed

2 files changed

+29
-52
lines changed

README.md

Lines changed: 28 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11

22
# Azure Management Libraries for .NET #
33

4-
This README is based on the released stable version (1.2). If you are looking for other releases, see [More Information](#more-information)
4+
This README is based on the released stable version (1.3). If you are looking for other releases, see [More Information](#more-information)
55

66
The Azure Management Libraries for .NET is a higher-level, object-oriented API for managing Azure resources. Libraries are built on the lower-level, request-response style [auto generated clients](https://github.com/Azure/azure-sdk-for-net/tree/AutoRest) and can run side-by-side with [auto generated clients](https://github.com/Azure/azure-sdk-for-net/tree/AutoRest).
77

8-
## Feature Availability and Road Map as of Version 1.2 ##
8+
## Feature Availability and Road Map as of Version 1.3 ##
99

1010
<table>
1111
<tr>
@@ -17,7 +17,7 @@ The Azure Management Libraries for .NET is a higher-level, object-oriented API f
1717
<tr>
1818
<td>Compute</td>
1919
<td>Virtual machines and VM extensions<br>Virtual machine scale sets<br>Managed disks</td>
20-
<td valign="top">Azure container service and registry</td>
20+
<td valign="top">Azure container service + registry + instances<br>Availability Zones</td>
2121
<td valign="top">More Azure container registry features</td>
2222
</tr>
2323
<tr>
@@ -35,14 +35,14 @@ The Azure Management Libraries for .NET is a higher-level, object-oriented API f
3535
<tr>
3636
<td>Networking</td>
3737
<td>Virtual networks<br>Network interfaces<br>IP addresses<br>Routing table<br>Network security groups<br>Application gateways<br>DNS<br>Traffic managers</td>
38-
<td valign="top">Load balancers<br>Network watchers</td>
38+
<td valign="top">Load balancers<br>Network peering<br>Virtual Network Gateway<br>Network watchers</td>
3939
<td valign="top">VPN<br>More application gateway features</td>
4040
</tr>
4141
<tr>
4242
<td>More services</td>
4343
<td>Resource Manager<br>Key Vault<br>Redis<br>CDN<br>Batch</td>
4444
<td valign="top">Web apps<br>Function Apps<br>Service bus<br>Graph RBAC<br>Cosmos DB<br>Search</td>
45-
<td valign="top">Monitor<br>Azure container instances<br>Data Lake</td>
45+
<td valign="top">Monitor<br>Data Lake</td>
4646
</tr>
4747
<tr>
4848
<td>Fundamentals</td>
@@ -221,7 +221,7 @@ var database = sqlServer.Databases.Define(databaseName)
221221

222222
# Sample Code #
223223

224-
You can find plenty of sample code that illustrates management scenarios (80+ end-to-end scenarios) for Azure Virtual Machines, Virtual Machine Scale Sets, Managed Disks, Active Directory Azure Container Service and Registry, Storage, Networking, Resource Manager, SQL Database, Cosmos DB, App Service (Web Apps on Windows and Linux), Functions, Service Bus, Key Vault, Redis, CDN and Batch …
224+
You can find plenty of sample code that illustrates management scenarios (95+ end-to-end scenarios) for Azure Virtual Machines, Virtual Machine Scale Sets, Managed Disks, Active Directory Azure Container Service and Registry, Storage, Networking, Resource Manager, SQL Database, Cosmos DB, App Service (Web Apps on Windows and Linux), Functions, Service Bus, Key Vault, Redis, CDN and Batch …
225225

226226
<table>
227227
<tr>
@@ -244,9 +244,10 @@ You can find plenty of sample code that illustrates management scenarios (80+ en
244244
<li><a href="https://github.com/Azure-Samples/managed-disk-dotnet-create-virtual-machine-using-specialized-disk-from-snapshot">Create virtual machine using specialized VHD from snapshot</a></li>
245245
<li><a href="https://github.com/Azure-Samples/managed-disk-dotnet-convert-existing-virtual-machines-to-use-managed-disks">Convert virtual machines to use managed disks</a></li>
246246
<li><a href="https://github.com/Azure-Samples/compute-dotnet-manage-virtual-machine-with-unmanaged-disks">Manage virtual machine with unmanaged disks</a></li>
247-
<li><a href="https://github.com/Azure-Samples/aad-dotnet-manage-resources-from-vm-with-msi">Manage Azure resources from a virtual machine with managed service identity (MSI)</a></li></ul></td>
248-
</ul>
249-
</td>
247+
<li><a href="https://github.com/Azure-Samples/aad-dotnet-manage-resources-from-vm-with-msi">Manage Azure resources from a virtual machine with managed service identity (MSI)</a></li>
248+
<li><a href="https://github.com/Azure-Samples/compute-dotnet-manage-vms-in-availability-zones">Manage virtual machines in availability zones</a></li>
249+
<li><a href="https://github.com/Azure-Samples/compute-dotnet-manage-vmss-in-availability-zones">Manage virtual machine scale sets in availability zones</a></li>
250+
</ul></td>
250251
</tr>
251252
<tr>
252253
<td>Virtual Machines - parallel execution</td>
@@ -273,14 +274,21 @@ You can find plenty of sample code that illustrates management scenarios (80+ en
273274
</ul></td>
274275
</tr>
275276
<tr>
276-
<td>Container Service and Container Registry</td>
277+
<td>Container Service<br>Container Registry and <br>Container Instances</td>
277278
<td><ul style="list-style-type:circle">
278279
<li><a href="https://github.com/Azure-Samples/acr-dotnet-manage-azure-container-registry">Manage container registry</a></li>
279280
<!-- <li><a href="https://github.com/Azure-Samples/acs-dotnet-deploy-image-from-acr-to-kubernetes">Deploy an image from container registry to Kubernetes cluster</a></li>
280281
<li><a href="https://github.com/Azure-Samples/acs-dotnet-deploy-image-from-acr-to-swarm">Deploy an image from container registry to Swarm cluster</li>
281282
<li><a href="https://github.com/Azure-Samples/acs-dotnet-deploy-image-from-docker-hub-to-kubernetes">Deploy an image from Docker hub to Kubernetes cluster</a></li>
282283
<li><a href="https://github.com/Azure-Samples/acs-dotnet-deploy-image-from-docker-hub-to-swarm">Deploy an image from Docker hub to Swarm cluster</li> -->
283284
<li><a href="https://github.com/Azure-Samples/acs-dotnet-manage-azure-container-service">Manage container service</li>
285+
<li><a href="https://github.com/Azure-Samples/aci-dotnet-manage-container-instances-1">Manage Azure Container Instances with new Azure File Share</li>
286+
<li><a href="https://github.com/Azure-Samples/aci-dotnet-manage-container-instances-2">Manage Azure Container Instances with an existing Azure File Share</li>
287+
<li><a href="https://github.com/Azure-Samples/aci-dotnet-create-container-groups">Create Container Group with multiple instances and container images</li>
288+
<li><a href="https://github.com/Azure-Samples/aci-dotnet-create-container-groups-using-private-registry">Create Container Group using images from a private registry</li>
289+
<!--
290+
<li><a href="https://github.com/Azure-Samples/aci-dotnet-scale-up-containers-using-kubernetes-in-acs">Create Container Group and scale up containers using Kubernetes in ACS</li>
291+
-->
284292
</ul></td>
285293
</tr>
286294
<tr>
@@ -301,8 +309,12 @@ You can find plenty of sample code that illustrates management scenarios (80+ en
301309
<li><a href="https://github.com/Azure-Samples/network-dotnet-manage-ip-address">Manage IP address</a></li>
302310
<li><a href="https://github.com/Azure-Samples/network-dotnet-manage-internet-facing-load-balancers">Manage Internet facing load balancers</a></li>
303311
<li><a href="https://github.com/Azure-Samples/network-dotnet-manage-internal-load-balancers">Manage internal load balancers</a></li>
304-
<li><a href="https://github.com/Azure-Samples/network-dotnet-use-new-watcher">Use net watcher</a></li>
305312
<li><a href="https://github.com/Azure-Samples/network-dotnet-create-simple-internet-facing-load-balancer">Create simple Internet facing load balancer</a></li>
313+
<li><a href="https://github.com/Azure-Samples/network-dotnet-use-new-watcher">Use net watcher</a>
314+
<li><a href="https://github.com/Azure-Samples/network-dotnet-manage-network-peering">Manage network peering between two virtual networks</a></li>
315+
<li><a href="https://github.com/Azure-Samples/network-dotnet-use-network-watcher-to-check-connectivity">Use network watcher to check connectivity between virtual machines in peered networks</a></li>
316+
<li><a href="https://github.com/Azure-Samples/network-dotnet-manage-virtual-network-with-site-to-site-vpn-connection">Manage virtual network with site-to-site VPN connection</a></li>
317+
<li><a href="https://github.com/Azure-Samples/network-dotnet-manage-virtual-network-to-virtual-network-vpn-connection">Manage virtual network to virtual network VPN connection</a></li>
306318
</ul>
307319
</td>
308320
</tr>
@@ -448,15 +460,16 @@ You can find plenty of sample code that illustrates management scenarios (80+ en
448460

449461
# Download #
450462

451-
**1.2** release builds are available on NuGet:
463+
**1.3** release builds are available on NuGet:
452464

453-
|Azure Management Library | Package name | Stable (1.2 release) |
465+
|Azure Management Library | Package name | Stable (1.3 release) |
454466
|---------------------------------------------|-----------------------------------------------------|------------------------|
455467
|Azure Management Client (wrapper package) | `Microsoft.Azure.Management.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.Fluent/) |
456468
|App Service (Web Apps and Functions) | `Microsoft.Azure.Management.AppService.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.AppService.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.AppService.Fluent/) |
457469
|Batch | `Microsoft.Azure.Management.Batch.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.Batch.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.Batch.Fluent/) |
458470
|CDN | `Microsoft.Azure.Management.Cdn.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.Cdn.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.Cdn.Fluent/) |
459471
|Virtual Machines, Virtual Machine Scale Sets, Azure Container Services| `Microsoft.Azure.Management.Compute.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.Compute.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.Compute.Fluent/) |
472+
|Container Instance | `Microsoft.Azure.Management.ContainerInstance.Fluent`| [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.ContainerInstance.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.ContainerInstance.Fluent/) |
460473
|Container Registry | `Microsoft.Azure.Management.ContainerRegistry.Fluent`| [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.ContainerRegistry.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.ContainerRegistry.Fluent/) |
461474
|Cosmos DB | `Microsoft.Azure.Management.CosmosDB.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.CosmosDB.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.CosmosDB.Fluent/) |
462475
|DNS | `Microsoft.Azure.Management.Dns.Fluent` | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.Management.Dns.Fluent.svg?style=flat-square&label=nuget)](https://www.nuget.org/packages/Microsoft.Azure.Management.Dns.Fluent/) |
@@ -480,7 +493,7 @@ You can find plenty of sample code that illustrates management scenarios (80+ en
480493

481494
# Help
482495

483-
If you are migrating your code to 1.2, you can use these notes for [preparing your code for 1.2 from 1.1](./notes/prepare-for-1.2.md).
496+
If you are migrating your code to 1.3, you can use these notes for [preparing your code for 1.3 from 1.2](./notes/prepare-for-1.3.md).
484497

485498
If you encounter any bugs with these libraries, please file issues via [Issues](https://github.com/Azure/azure-libraries-for-net/issues) or checkout [StackOverflow for Azure Management Libraries for .NET](http://stackoverflow.com/questions/tagged/azure-sdk).
486499

@@ -504,6 +517,7 @@ If you would like to become an active contributor to this project please follow
504517

505518
| Version | SHA1 | Remarks |
506519
|-------------------|-------------------------------------------------------------------------------------------|-------------------------------------------------------|
520+
| 1.3 | [1.3](https://github.com/Azure/azure-libraries-for-net/releases/tag/Fluent-v1.3) | Tagged release for 1.3 version of Azure management libraries |
507521
| 1.2 | [1.2](https://github.com/Azure/azure-sdk-for-net/releases/tag/Fluent-v1.2) | Tagged release for 1.2 version of Azure management libraries |
508522
| 1.1 | [1.1](https://github.com/Azure/azure-sdk-for-net/releases/tag/Fluent-v1.1) | Tagged release for 1.1 version of Azure management libraries |
509523
| 1.0 | [1.0](https://github.com/Azure/azure-sdk-for-net/releases/tag/Fluent-v1.0.0-stable) | Tagged release for 1.0 version of Azure management libraries |

notes/prepare-for-1.3.md

Lines changed: 1 addition & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -6,41 +6,4 @@ Steps to migrate code that uses Azure Management Libraries for .NET from 1.2 to
66
77
V1.3 is backwards compatible with V1.2 in the APIs intended for public use that reached the general availability (stable) stage in V1.0.
88

9-
Some breaking changes were introduced in APIs that were still in Beta in V1.2 (as indicated by their inheritance from the `IBeta` interface.)
10-
11-
12-
### Renames
13-
14-
<table>
15-
<tr>
16-
<th align=left>From</th>
17-
<th align=left>To</th>
18-
<th align=left>Ref</th>
19-
</tr>
20-
<tr>
21-
<td><code></code></td>
22-
<td><code></code></td>
23-
<td><a href=""></a></td>
24-
</tr>
25-
</table>
26-
27-
### API Removals
28-
29-
<table>
30-
<tr>
31-
<th>Removed</th>
32-
<th>Alternate to switch to</th>
33-
</tr>
34-
<tr>
35-
<td><code>IPacketCapture.DefinePacketCaptureFilter</code></td>
36-
<td><code>IPacketCapture.DefinePacketCaptureFilter()</code> <i>(method)</i></td>
37-
</tr>
38-
<tr>
39-
<td><code>INetworkWatcher.VerifyIPFlow</code></td>
40-
<td><code>INetworkWatcher.VerifyIPFlow()</code> <i>(method)</i></td>
41-
</tr>
42-
<tr>
43-
<td><code>INetworkWatcher.NextHop</code></td>
44-
<td><code>INetworkWatcher.NextHop()</code> <i>(method)</i></td>
45-
</tr>
46-
</table>
9+
There were no breaking changes introduced even in APIs that were still in Beta in V1.2 (as indicated by their inheritance from the `IBeta` interface.)

0 commit comments

Comments
 (0)