Skip to content
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.

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

RunCommands 2018-06-01 #3422

Merged
merged 2 commits into from
Jul 19, 2018
Merged

RunCommands 2018-06-01 #3422

merged 2 commits into from
Jul 19, 2018

Conversation

lmazuel
Copy link
Member

@lmazuel lmazuel commented Jul 16, 2018

For Azure Profile to work properly, we need either:

  • Each Swagger files to own his operation group
  • If plug into another operation group from another file, to be consistent with that file.

However, "runCommands" plugs into the operation group VirtualMachines the operation RunCommand. Being that latest VirtualMachines is 2018-06-01 and latest runCommands is 2018-04-01, this breaks the contract and creates Readme that cannot be used for Azure Profile.

Discussed with @hyonholee the first time this occured that in theory when a new Compute is out, RunCommands is out at the same time and this just requires copying the file.

Note that the examples were copied without the Swagger, with the wrong api-version content.

@AutorestCI
Copy link

AutorestCI commented Jul 16, 2018

Automation for azure-sdk-for-python

The initial PR has been merged into your service PR:
Azure/azure-sdk-for-python#2487

@AutorestCI
Copy link

AutorestCI commented Jul 16, 2018

Automation for azure-sdk-for-ruby

Nothing to generate for azure-sdk-for-ruby

@AutorestCI
Copy link

AutorestCI commented Jul 16, 2018

Automation for azure-sdk-for-node

Nothing to generate for azure-sdk-for-node

@AutorestCI
Copy link

AutorestCI commented Jul 16, 2018

Automation for azure-sdk-for-go

Nothing to generate for azure-sdk-for-go

@AutorestCI
Copy link

AutorestCI commented Jul 16, 2018

Automation for azure-sdk-for-java

Nothing to generate for azure-sdk-for-java

@lmazuel
Copy link
Member Author

lmazuel commented Jul 17, 2018

@huangpf for review

@@ -4,7 +4,7 @@
"resourceGroupName": "crptestar98131",
"vmName": "vm3036",
"$top": "1",
"api-version": "2017-12-01",
"api-version": "2018-06-01",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Was this intended at that time, or it's just found as typo errors till now?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This file was copied from 2017-12-01 to 2018-06-01 folder with no reasons, since the Swagger which was mentioning it didn't exist. This is correct then the correct content for the file.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But it may be intended by the service API team. What if the RunCommand APIs (for some reason) don't work with this new API version? Swagger spec correctness is important, but we can't also expose something here that the service API is not ready to expose.

@hyonholee Can you help involve Atanas to help confirm? Thanks.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please see prev version example when the API has changes:
https://github.com/Azure/azure-rest-api-specs/blob/master/specification/compute/resource-manager/Microsoft.Compute/stable/2018-04-01/examples/VirtualMachineRunCommand.json

The output: [ ] become wrapped in json object
output: {value: [ ] }

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

changed

@@ -184,6 +184,7 @@ These settings apply only when `--tag=package-compute-only-2018-06` is specified
``` yaml $(tag) == 'package-compute-only-2018-06'
input-file:
- Microsoft.Compute/stable/2018-06-01/compute.json
- Microsoft.Compute/stable/2018-06-01/runCommands.json
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please attach C# SDK test validation proof, because this is what we all do.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't understand? This is a Swagger question, I don't do C# and I'm not in the C# team, I'm in the Swagger team. This PR is just a friendly reminder that this is needed in order to ship CLI with 2018-06-01 support.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can understand your workflow is to patch the specification, and SDK release is not your concern. But if you can waive the SDK proof part, can we also get a waiver onwards? @hyonholee

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's continue this by email, thank you

"info": {
"title": "RunCommandsClient",
"description": "The Run Commands Client.",
"version": "2018-06-01"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@yugangw-msft
Copy link
Contributor

yugangw-msft commented Jul 18, 2018

@lmazuel once this gets merged, please release python sdk of azure-mgmt-compute including everything

@lmazuel lmazuel merged commit be9bf1a into Azure:master Jul 19, 2018
@lmazuel lmazuel deleted the runcommands2018-06-01 branch July 19, 2018 17:20
mccleanp pushed a commit that referenced this pull request Mar 23, 2022
* adding inventory item props

* update
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants