From 94ad7b7480c36a6a59be024624a273447bac698c Mon Sep 17 00:00:00 2001 From: nickzhums <56864335+nickzhums@users.noreply.github.com> Date: Wed, 16 Sep 2020 18:11:29 +0800 Subject: [PATCH 1/7] Update python mgmt libraries message --- README.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 3f390f79ffa8..9d670c5b9090 100644 --- a/README.md +++ b/README.md @@ -35,13 +35,15 @@ You can find the [most up to date list of all of the new packages on our page](h Last stable versions of packages that have been provided for usage with Azure and are production-ready. These libraries provide you with similar functionalities to the Preview ones as they allow you to use and consume existing resources and interact with them, for example: upload a blob. They might not implement the [guidelines](https://azure.github.io/azure-sdk/python_introduction.html) or have the same feature set as the Novemeber releases. They do however offer wider coverage of services. ### Management: New Releases -A new set of management libraries that follow the [Azure SDK Design Guidelines for Python](https://azure.github.io/azure-sdk/python/guidelines/) are now in Public Preview. These new libraries provide a number of core capabilities that are shared amongst all Azure SDKs, including the intuitive Azure Identity library, an HTTP Pipeline with custom policies, error-handling, distributed tracing, and much more. -You can find the list of new packages [on this page](https://azure.github.io/azure-sdk/releases/latest/mgmt/python.html). Documentation and for these new libraries can be found [here](https://aka.ms/azure-sdk-python-mgmt). Code samples can also be viewed [here](https://docs.microsoft.com/samples/browse/?languages=python&term=Getting%20started%20-%20Managing). In addition, a migration guide that shows how to transition from older versions of libraries is located [here](https://github.com/Azure/azure-sdk-for-python/blob/master/doc/sphinx/python_mgmt_migration_guide.rst). +A new set of management libraries that follow the [Azure SDK Design Guidelines for Python](https://azure.github.io/azure-sdk/python/guidelines/) are now available. These new libraries provide a number of core capabilities that are shared amongst all Azure SDKs, including the intuitive Azure Identity library, an HTTP Pipeline with custom policies, error-handling, distributed tracing, and much more. +Documentation and code samples for these new libraries can be found [here](https://aka.ms/azure-sdk-python-mgmt). In addition, a migration guide that shows how to transition from older versions of libraries is located [here](https://azure.github.io/azure-sdk-for-python/mgmt_preview_quickstart.html#migration-guide). + +You can find the [most up to date list of all of the new packages on our page](https://azure.github.io/azure-sdk/releases/latest/mgmt/python.html) > NOTE: If you need to ensure your code is ready for production use one of the stable, non-preview libraries. ### Management: Previous Versions -For a complete list of management libraries which enable you to provision and manage Azure resources, please check [here](https://azure.github.io/azure-sdk/releases/latest/all/python.html). They might not have the same feature set as the new releases but they do offer wider coverage of services. +For a complete list of management libraries which enable you to provision and manage Azure resources, please [check here](https://azure.github.io/azure-sdk/releases/latest/all/python.html). They might not have the same feature set as the new releases but they do offer wider coverage of services. Management libraries can be identified by namespaces that start with `azure-mgmt-`, e.g. `azure-mgmt-compute` ## Need help? From 03393dee40567cff8297991a11d9e253ccbfe136 Mon Sep 17 00:00:00 2001 From: nickzhums <56864335+nickzhums@users.noreply.github.com> Date: Mon, 21 Sep 2020 10:55:32 +0800 Subject: [PATCH 2/7] Update and rename mgmt_preview_quickstart.rst to mgmt_quickstart.rst --- ..._preview_quickstart.rst => mgmt_quickstart.rst} | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) rename doc/sphinx/{mgmt_preview_quickstart.rst => mgmt_quickstart.rst} (94%) diff --git a/doc/sphinx/mgmt_preview_quickstart.rst b/doc/sphinx/mgmt_quickstart.rst similarity index 94% rename from doc/sphinx/mgmt_preview_quickstart.rst rename to doc/sphinx/mgmt_quickstart.rst index 45d6c9617073..98002433ec09 100644 --- a/doc/sphinx/mgmt_preview_quickstart.rst +++ b/doc/sphinx/mgmt_quickstart.rst @@ -1,21 +1,21 @@ -Quickstart Tutorial - Resource Management (Preview Libraries) +Quickstart Tutorial - Resource Management =============================================================== -We are excited to announce that a new set of management libraries are now in Public Preview. +We are excited to announce that a new set of management libraries are now generally available. Those packages share a number of new features such as Azure Identity support, HTTP pipeline, error-handling.,etc, and they also follow the new Azure SDK guidelines which create easy-to-use APIs that are idiomatic, compatible, and dependable. -You can find the details of those new libraries `here `__ +You can find the details of those new libraries `here `__ In this basic quickstart guide, we will walk you through how to -authenticate to Azure using the preview libraries and start interacting with +authenticate to Azure using the new libraries and start interacting with Azure resources. There are several possible approaches to authentication. This document illustrates the most common scenario Migration Guide --------------- -If you are an existing user of the older version of Azure management library for Python and you are looking for a migration guide to the new beta version of the SDK, please refer to `this migration guide here `__ +If you are an existing user of the older version of Azure management library for Python and you are looking for a migration guide to the new version of the SDK, please refer to `this migration guide here `__ Prerequisites ------------- @@ -253,11 +253,11 @@ Note that asyncio in Windows is underpowered and please take caution when using Code Samples ------------------------- -For more code samples that demonstrate how to use our SDK to interact with Azure services, please visit `here `__ +For more code samples that demonstrate how to use our SDK to interact with Azure services, please visit `here `__. You can also view the Github repo that contains the code samples `here `__ Need help? ---------- -- File an issue via `Github Issues `__ and make sure you add the "Preview" label to the issue +- File an issue via `Github Issues `__ - Check `previous questions `__ or ask new ones on StackOverflow using azure and python tags. Contributing From a73a91678a51e51ee5323b8c8321150c21d622e5 Mon Sep 17 00:00:00 2001 From: nickzhums <56864335+nickzhums@users.noreply.github.com> Date: Mon, 21 Sep 2020 11:07:52 +0800 Subject: [PATCH 3/7] Update python_mgmt_migration_guide.rst --- doc/sphinx/python_mgmt_migration_guide.rst | 34 ++++++++++++---------- 1 file changed, 18 insertions(+), 16 deletions(-) diff --git a/doc/sphinx/python_mgmt_migration_guide.rst b/doc/sphinx/python_mgmt_migration_guide.rst index 695d227d8208..fbfd254ecffe 100644 --- a/doc/sphinx/python_mgmt_migration_guide.rst +++ b/doc/sphinx/python_mgmt_migration_guide.rst @@ -11,7 +11,7 @@ libraries For users new to the Python SDK for resource management libraries, please see the `quickstart -guide `__ +guide `__ Table of contents ----------------- @@ -32,21 +32,23 @@ Prerequisites Updated Python Packages ----------------------- -Currently, all next-generation Python SDK management client libraries -are in Public Preview. The preview version SDK will be contain a ``b`` -in its version to number to indicate that it's a beta release (e.g. -``17.0.0b1``). The versioning information can be found on the release -history page of each Azure service on pypi.org. Take Azure Compute -service for example, the release history can be found at -`https://pypi.org/project/azure-mgmt-compute/17.0.0b1/history `__ - -You can also refer to the `this +You can refer to the `this site `__ -to see all the latest Python packages. +to see all the new Python packages. + +For packages that are already generally available (GA), you can directly install the package using pip. Take Azure Compute +service for example, simply do: +``pip install azure-mgmt-compute`` + +The release history for azure-mgmt-compute can be found at `https://pypi.org/project/azure-mgmt-compute/#history `__ + +You will notice that there was a beta release in release history, and the changelog for this version mentioned that "this version uses a next-generation code generator that introduces important breaking changes". This indicates the package is based on the new generator. + +In addition, some next-generation Python SDK management client libraries might still in Public Preview. The preview version SDK will be contain a ``b`` in its version to number to indicate that it's a beta release (e.g.``10.0.0b1``). -Please install the package based on the beta version number, for -example, to install the latest preview package for Compute, please use: -``pip install azure-mgmt-compute==17.0.0b1`` +For those beta releases, please install the package based on the beta version number, for +example, to install the latest preview package for BetaServiceExample, please use: +``pip install azure-mgmt-beta-service-example==10.0.0b1`` General Changes --------------- @@ -107,7 +109,7 @@ To the show the code snippets for the change: compute_client = azure.mgmt.compute.ComputeManagementClient(credential=credential, subscription_id=self.subscription_id) For detailed information on the benefits of using the new authentication -classes, please refer to `this +classes as well as all available authentication options, please refer to `this page `__ Client API Changes @@ -154,7 +156,7 @@ Additional Samples More samples can be found at : -- `Quickstart for new version of SDK `__ +- `Quickstart for new version of SDK `__ - `Code Samples for Resource Management Libraries `__ - `Authentication Documentation `__ From c5016a5be276b8cc81ab17dbf7da03a317a66a22 Mon Sep 17 00:00:00 2001 From: nickzhums <56864335+nickzhums@users.noreply.github.com> Date: Mon, 21 Sep 2020 11:08:32 +0800 Subject: [PATCH 4/7] Update index.rst --- doc/sphinx/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/sphinx/index.rst b/doc/sphinx/index.rst index a0c7e4f3a67a..e426a8fcc2d3 100644 --- a/doc/sphinx/index.rst +++ b/doc/sphinx/index.rst @@ -65,7 +65,7 @@ section of the project. installation quickstart_authentication - mgmt_preview_quickstart + mgmt_quickstart python_mgmt_migration_guide multicloud exceptions From 89156b00fa1ac6649c10b58591e1a9ad6bce0d80 Mon Sep 17 00:00:00 2001 From: nickzhums <56864335+nickzhums@users.noreply.github.com> Date: Mon, 21 Sep 2020 17:46:28 +0800 Subject: [PATCH 5/7] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9d670c5b9090..4c5933729630 100644 --- a/README.md +++ b/README.md @@ -40,7 +40,7 @@ Documentation and code samples for these new libraries can be found [here](https You can find the [most up to date list of all of the new packages on our page](https://azure.github.io/azure-sdk/releases/latest/mgmt/python.html) -> NOTE: If you need to ensure your code is ready for production use one of the stable, non-preview libraries. +> NOTE: If you need to ensure your code is ready for production use one of the stable, non-preview libraries. Also, if you are experiencing authentication issues with the management libraries after upgrading certain packages, it's possible that you upgraded to the new versions of SDK without changing the authentication code, please refer to the documenation above for more info. ### Management: Previous Versions For a complete list of management libraries which enable you to provision and manage Azure resources, please [check here](https://azure.github.io/azure-sdk/releases/latest/all/python.html). They might not have the same feature set as the new releases but they do offer wider coverage of services. From 4f44bdd889e79b4c0d2f6adb23f1886174cb7dfb Mon Sep 17 00:00:00 2001 From: nickzhums <56864335+nickzhums@users.noreply.github.com> Date: Tue, 22 Sep 2020 12:23:41 +0800 Subject: [PATCH 6/7] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 4c5933729630..d9dda5a218d7 100644 --- a/README.md +++ b/README.md @@ -40,7 +40,7 @@ Documentation and code samples for these new libraries can be found [here](https You can find the [most up to date list of all of the new packages on our page](https://azure.github.io/azure-sdk/releases/latest/mgmt/python.html) -> NOTE: If you need to ensure your code is ready for production use one of the stable, non-preview libraries. Also, if you are experiencing authentication issues with the management libraries after upgrading certain packages, it's possible that you upgraded to the new versions of SDK without changing the authentication code, please refer to the documenation above for more info. +> NOTE: If you need to ensure your code is ready for production use one of the stable, non-preview libraries. Also, if you are experiencing authentication issues with the management libraries after upgrading certain packages, it's possible that you upgraded to the new versions of SDK without changing the authentication code, please refer to the migration guide mentioned above for proper instructions. ### Management: Previous Versions For a complete list of management libraries which enable you to provision and manage Azure resources, please [check here](https://azure.github.io/azure-sdk/releases/latest/all/python.html). They might not have the same feature set as the new releases but they do offer wider coverage of services. From e39ccaea9bdd44a2d3f6406ae9afb2f9bcce2366 Mon Sep 17 00:00:00 2001 From: nickzhums <56864335+nickzhums@users.noreply.github.com> Date: Tue, 22 Sep 2020 16:21:19 +0800 Subject: [PATCH 7/7] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index d9dda5a218d7..7be0ecafcbce 100644 --- a/README.md +++ b/README.md @@ -36,7 +36,7 @@ Last stable versions of packages that have been provided for usage with Azure an ### Management: New Releases A new set of management libraries that follow the [Azure SDK Design Guidelines for Python](https://azure.github.io/azure-sdk/python/guidelines/) are now available. These new libraries provide a number of core capabilities that are shared amongst all Azure SDKs, including the intuitive Azure Identity library, an HTTP Pipeline with custom policies, error-handling, distributed tracing, and much more. -Documentation and code samples for these new libraries can be found [here](https://aka.ms/azure-sdk-python-mgmt). In addition, a migration guide that shows how to transition from older versions of libraries is located [here](https://azure.github.io/azure-sdk-for-python/mgmt_preview_quickstart.html#migration-guide). +Documentation and code samples for these new libraries can be found [here](http://aka.ms/azsdk/python/mgmt). In addition, a migration guide that shows how to transition from older versions of libraries is located [here](https://azure.github.io/azure-sdk-for-python/mgmt_preview_quickstart.html#migration-guide). You can find the [most up to date list of all of the new packages on our page](https://azure.github.io/azure-sdk/releases/latest/mgmt/python.html)