Skip to content

{Docs} Roadmap for track2 migration #16532

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jsntcy merged 7 commits into from
Jan 25, 2021
Merged

{Docs} Roadmap for track2 migration #16532

Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
77618d3
Draft roadmap for track2 migration
jsntcy Jan 14, 2021
fa9e5d9
Update doc: add extension roadmap
jsntcy Jan 18, 2021
904f2c1
Update roadmap
jsntcy Jan 21, 2021
0149f87
Update roadmap
jsntcy Jan 21, 2021
10343b3
Update roadmap for CAE support
jsntcy Jan 25, 2021
acafff1
Fix typo
jsntcy Jan 25, 2021
b547d40
Update plan
jsntcy Jan 25, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
149 changes: 149 additions & 0 deletions doc/track_2_migration_roadmap.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,149 @@
# Track 2 SDK Migration Roadmap
This document provides the roadmap for Track 2 SDK migration in Azure CLI. When you migrate your module to Track 2 SDK, you can go to [Track 2 migration guidance](track_2_migration_guidance.md) to check how to migrate to Track 2 SDK.

## Why do we need migrate Track 1 SDK to Track 2 SDK in Azure CLI?
- Track 1 SDK will be eventually deprecated sometime in the future.
- Some new features will only be in track2 SDK in the future.

## Here are criteria to determine the priority of migration:
- On-demand for Track 2 SDK from CLI customers (such as CAE support from LinkedIn) has higher priority.
- On-demand for Track 2 SDK from service team has higher priority.
- The smaller the gap between Track 1 SDK version and Track 2 SDK version, the higher priority.
- The more frequent release, the higher priority.
- If Track 1 SDK is in preview (0.x.x or x.x.xrc), the lower priority.
- Extenison has lower priority.

## Here is the proposed roadmap for managment plane migration. (Total ~60 CLI modules: 6 completed and ~60 extensions: 20 completed.)

- To meet CAE requirements (`CAE support` column is `Yes` in the table below),
- 12 services need to be migrated by the end of 0/30/2021.
- 4 services need to be migrated by the end of 06/30/2021.
- Totally 18 services need to be migrated by the end of 06/30/2021.
- To achieve this goal:
- We need notify service teams ahead of time so that they have sufficient time to migrate.
- If there is no Track 2 SDK for those services, we'll release stable Track 2 SDK version for them before 03/11/2021.
- If the Track 2 SDK for those services is in preview, we'll release stable Track 2 SDK version for them before 02/11/2021.

| Module | CAE support | Migration Status | ETA | Latest Track 2 SDK Status | Latest Track 1 SDK status | Release frequency | CLI Module or Extension |
| --------- |:-------------:| :-----:|:-----:|:--:|:--:|:--:|:--:|
|**Phase 1: Compute, Network, Storage** | | | | | | |||
| Network |Yes| **Completed** | 04/30/2021 | GA (17.0.0) | GA (13.0.0) | High (Once a month)| Module |
| Storage |Yes|**Completed** | 04/30/2021 | GA (16.0.0) | GA (11.2.0) | Medium (Once two months) | Module |
| Compute | Yes|**Completed** | 04/30/2021 |GA (18.0.0) | GA (14.0.0) | High (Once a month) | Module |
| KeyVault | Yes|**Completed** | 04/30/2021 |GA (8.0.0) | GA (2.2.0) | Medium (Once three months) | Module |
| Monitor |Yes |**Completed** | 04/30/2021 |Monitor: GA (2.0.0)<br> LogAnalytics: GA (8.0.0) | Monitor: Preview (0.12.0)<br> LogAnalytics: GA (2.0.0) | Medium (Once two months) | Module |
| Resource | Yes |Not Started | 04/30/2021 |GA (15.0.0) | GA (12.0.0) | Medium (Once two months) | Module |
| AppService | Yes|Not Started | 04/30/2021 |GA (1.0.0) | Preview (0.48.0) | Medium (Once three months) | Module |
| ACS | Yes |Not Started | 04/30/2021 |ContainerService: GA (14.0.0)<br> ContainerInstance: GA (7.0.0) | ContainerService: GA (11.0.0)<br> ContainerInstance: GA (2.0.0) | Medium (Once two months) | Module |
| ACR | Yes |Not Started | 04/30/2021 |Preview (8.0.0b1) | Preview (3.0.0rc16) | Medium (Once two months) | Module |
| CosmosDB | Yes |Not Started | 04/30/2021 |GA (6.0.0) | Preview (2.0.0rc1) | Medium (Once two months) |Module|
| ServiceBus | Yes |Not Started | 04/30/2021 |GA (6.0.0) | GA (1.0.0) | Medium (Once four months) | Module |
| CDN | Yes |Not Started | 04/30/2021 |GA (10.0.0) | GA (6.0.0) | Low (Once half year) | Module |
| NetAppFiles | Yes |Not Started | 04/30/2021 |Preview (1.0.0b1) | Preview (0.15.0) | Medium (Once two months) | Module|
| PrivateDNS | Yes | Not Started | 04/30/2021 |N/A | Preview (0.1.0) |N/A | Module |
| ApplicationInsights |Yes | Not Started | 04/30/2021 |Preview (1.0.0b1) | Vendored_Preview (0.2.0) | N/A | Extension |
| Firewall |Yes| Not Started | 04/30/2021 | N/A | Vendored_GA (13.0.0) | N/A | Extension |
| Frontdoor | Yes | Not Started | 04/30/2021 |N/A | Vendored_Preview (0.3.1) | N/A | Extension |
|**Phase 2: Management&Governance&others** | | | | | | |||
| CostManagement | Yes | **Completed** | 06/30/2021 |Vendored_GA (1.2.0) | N/A | N/A | Extension |
| DataFactory | Yes | **Completed** | 06/30/2021 |Vendored_SDK | N/A | N/A | Extension |
| RDBMS | Yes|Not Started | 06/30/2021 |GA (8.0.0) | Preview (3.1.0rc1) | Medium (Once two months) | Module |
| EventGrid | Yes |Not Started | 06/30/2021 | GA (8.0.0) | Preview (3.0.0rc8) | Medium (Once three months) | Module |
| HDInsight | Yes |Not Started | 06/30/2021 | GA (7.0.0) | GA (2.1.0) | Medium (Once two months) | Module |
| Kusto | Yes |Not Started | 06/30/2021 |Preview (1.0.0b1) | Preview (0.10.0) | Medium (Once two months | Module |
| SQL | No |Not Started | 06/30/2021 |GA (1.0.0) | Preview (0.25.0) | Medium (Once two months) | Module |
| Role | No |Not Started | 06/30/2021 | Authorization: GA (1.0.0) | Authorization: Preview (0.61.0) | Low (Once a year) | Module |
|**Phase 3** | | | | | | |||
| NatGateway || **Completed** | N/A | Network: GA (8.0.0) | Network: GA (2.2.0) | Use Network package| Module |
| Synapse | |Not Started | N/A |Preview (1.0.0b1) | Preview (0.6.0) | Medium (Once two months) | Module |
| EventHub | |Not Started | N/A |GA (8.0.0) | GA (4.2.0) | Low (Once a year) | Module |
| Search | |Not Started | N/A |GA (8.0.0) | GA (3.0.0) | Low (Once a year) | Module |
| AppConfiguration | |Not Started | N/A |GA (1.0.1) | Preview (0.6.0) | Medium (Once three months) | Module |
| Security | |Not Started | N/A |GA (1.0.0) | Preview (0.6.0) | Medium (Once three months) | Module |
| Batch | |Not Started | N/A |GA (14.0.0) | GA (9.0.0) | Low (Once half year) | Module |
| CognitiveServices | |Not Started | N/A | GA (11.0.0) | GA (6.3.0) | Low (Once half year) | Module |
| DevTestLabs | |Not Started | N/A |GA (9.0.0) | GA (4.0.0) | Low (Once half year) | Module |
| SignalR | |Not Started | N/A | Preview (1.0.0b1) | Preview (0.4.0) | Low (Once half year) | Module |
| PolicyInsights | |Not Started | N/A | GA (1.0.0) | Preview (0.6.0) | Low (Once half year) | Module |
| Reservations | |Not Started | N/A |Preview (1.0.0b1) | Preview (0.8.0) | Low (Once half year) | Module |
| Advisor | |Not Started | N/A |GA (9.0.0) | GA (4.0.0) | Low (once eight months) | Module |
| Media | |Not Started | N/A |Preview (7.0.0b1) | GA (3.0.0) | Low (Once a year) | Module |
| Consumption | |Not Started | N/A |GA (8.0.0) | GA (3.0.0) | Low (Once a year) | Module |
| ContainerInstance | |Not Started | N/A |GA (7.0.0) | GA (2.0.0) | Low (Once a year) | Module |
| Billing | |Not Started | N/A |Preview (6.0.0b1) | GA (1.0.0) | Low (Once a year) | Module |
| DataMigration | |Not Started | N/A |Preview (9.0.0b1) | GA (4.1.0) | Low (Once a year) | Module |
| Redis | |Not Started | N/A |GA (12.0.0) | Preview (7.0.0rc2) | Low (Once a year) | Module |
| APIManagement | |Not Started | N/A |GA (1.0.0) | Preview (0.2.0) | Low (Once a year) | Module |
| RedhatOpenShift | |Not Started | N/A|Preview (1.0.0b1) | Preview (0.1.0) | Low (Once a year) | Module |
| DataBoxEdge | |Not Started | N/A|Preview (1.0.0b1) | Preview (0.2.0) | Low (Once a year) | Module |
| ServiceFabric | |Not Started | N/A|Preview (1.0.0b1) | Preview (0.5.0) | Low (Once a year) | Module |
| Relay | |Not Started | N/A|GA (1.0.0) | Preview (0.2.0) | Low (Once two years) | Module |
| DeploymentManager | |Not Started | N/A|Preview (1.0.0b1) | Preview (0.2.0) | Low (Once two years) | Module |
| BotService | |Not Started | N/A|Preview (1.0.0b1) | Preview (0.2.0) | Low (Once two years) | Module |
| ManagedServices | |Not Started | N/A| Preview (6.0.0b1) | GA (1.0.0) | Low (Once two years) | Module |
| Maps | |Not Started | N/A|Preview (1.0.0b1) | Preview (0.1.0) | Low (Once three years) | Module |
| Backup | |Not Started | N/A| RecoveryServices: GA (1.0.0)<br> RecoveryServicesBackup: N/A | RecoveryServices: Preview (0.6.0)<br> RecoveryServicesBackup: Preview (0.11.0) | Low (Once half year) | Module |
| IoTHub | | Not Started | N/A |IoTHub: GA (1.0.0) <br> IoTCentral: N/A <br> IoTHubProvisioningServices: N/A | IoTHub: Preview (0.12.0) <br> IoTCentral: GA (4.0.0) <br> IoTHubProvisioningServices: Preview (0.2.0)| | Module |
| BatchAI | | Not Started | N/A | N/A | GA (2.0.0) | | Module |
| DataLakeAnalytics | | Not Started | N/A |N/A | Preview (0.6.0) | | Module |
| DataLakeStore | | Not Started | N/A (Will incorporate into storage SDK) |N/A | Preview (0.5.0) | | Module |
| Role | | Not Started | N/A |MSI: N/A | MSI: GA (1.0.0) | | Module |
| Account | | **Completed** | N/A |Subscription: Vendored_Preview (0.5.0) | N/A | N/A | Extension |
| Attestation | | **Completed** | N/A |Vendored_SDK | N/A | N/A | Extension |
| Automation | | **Completed** | N/A |Vendored_SDK | N/A | N/A | Extension |
| Communication | | **Completed** | N/A |Vendored_SDK | N/A | N/A | Extension |
| ConnectedMachine | | **Completed** | N/A |Vendored_SDK | N/A | N/A | Extension |
| DataDog | | **Completed** | N/A |Vendored_SDK | N/A | N/A | Extension |
| DataShare | | **Completed** | N/A |Vendored_SDK | N/A | N/A | Extension |
| DesktopVirtualization | | **Completed** | N/A |Vendored_Preview (0.2.0) | N/A | N/A | Extension |
| Footprint | | **Completed** | N/A |Vendored_SDK | N/A | N/A | Extension |
| GuestConfig | | **Completed** | N/A |Vendored_SDK | N/A | N/A | Extension |
| HardwareSecutiryModules | | **Completed** | N/A |Vendored_SDK | N/A | N/A | Extension |
| HealthCareAPIs | | **Completed** | N/A |Vendored_Preview (0.3.0) | N/A | N/A | Extension |
| Import-Export | | **Completed** | N/A |Vendored_SDK | N/A | N/A | Extension |
| Footprint | | **Completed** | N/A |Vendored_SDK | N/A | N/A | Extension |
| Logic | | **Completed** | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| Maintenance | | **Completed** | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| Peering | | **Completed** | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| Portal | | **Completed** | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| StackHCI | | **Completed** | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| AKS-Preview | | Not Started | N/A |N/A | ContainerService: Vendored_GA (0.2.0) | N/A | Extension |
| AlertsManagement | | Not Started | N/A |N/A | Vendored_Preview (0.2.0rc2) | N/A | Extension |
| BlockChain | | Not Started | N/A |N/A | Vendored_GA (2.0.0) | N/A | Extension |
| BluePrint | | Not Started | N/A |N/A | Vendored_Preview (2018-11-01-preview) | N/A | Extension |
| CodeSpaces | | Not Started | N/A |N/A | Vendored_SDK | N/A | Extension |
| ConnectedK8S | | Not Started | N/A |N/A | Vendored_Preview (0.1.1) | N/A | Extension |
| CustomProviders | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| DataBox | | Not Started | N/A |N/A | Vendored_Preview (0.2.0) | N/A | Extension |
| DataBricks | | Not Started | N/A |N/A | Vendored_Preview (0.1.0 | N/A | Extension |
| DB-Up | | Not Started | N/A |N/A | RDBMS: Vendored_GA (1.5.0) <br> SQL: Vendored_Preview (0.11.0) | N/A | Extension |
| DMS-Preview | | Not Started | N/A |N/A | Vendored_GA (4.0.0) | N/A | Extension |
| ExpressRouteCrossConnection || Not Started | N/A | N/A | Network: Vendored_SDK | N/A | Extension |
| Hack | | Not Started | N/A |N/A | Call AppService, CosmosDB, RDBMS, CognitiveServices | N/A | Extension |
| HPC-Cache || Not Started | N/A | N/A | Vendored_Preview (0.2.0 | N/A | Extension |
| InternetAnalyzer || Not Started | N/A | N/A | Frontdoor: Vendored_Preview (0.3.0) | N/A | Extension |
| Ip-Group | | Not Started | N/A |N/A | Network: Vendored_SDK | N/A | Extension |
| K8SConfiguration | | Not Started | N/A |N/A | Vendored_SDK) | N/A | Extension |
| Log-Analytics | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| ManagementPartner | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| Mesh | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| Mixed-Reality | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| NotificationHub | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| PowerbiDedicated | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| ResourceGraph | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| SecurityInsight | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| SpringCloud | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| StorageSync | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| Stream-Analytics | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| Support | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| TimeSeriesInsights | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| VMWare | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| VirtualWan | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| Swiftlet | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| ScheduledQuery | | Not Started | N/A |N/A | Vendored_Preview (0.1.0) | N/A | Extension |
| *Below services don't exist in CLI repo*| | | | | | |||
| Azure Security Center | Yes | | 06/30/2021 | | | | |
| Sentinel| Yes | | 06/30/2021 | | | | |
| Azure Data Explorer| Yes | | 06/30/2021 | | | | |
| Azure DevOps| Yes | | 06/30/2021 | | | | |
| Azure Machine Learning| Yes | | 06/30/2021 | | | | |