https://pulumi.com logo
Title
e

enough-caravan-98871

02/02/2023, 5:05 PM
Hello everyone! I am having trouble creating a new Azure App Service Environment with @pulumi/azure-native. It does not appear that it is using the latest MS API and I am not even sure it is supporting 'v3' ASEs, which is what I am trying to create. I see that @pulumi/azure 'classic' had a clear separation between legacy and v3 ASEs. Does anyone know the status of that in native? I seem to keep running into this general challenge across multiple Azure resource types.
f

fresh-summer-65887

02/02/2023, 5:17 PM
I don't know if this will fix your specific issue but I've found myself having to use the "preview" APIs to get latest MS API alignment. There will be differences here not aligned with the published API docs on pulumi.com.
m

melodic-tomato-39005

02/02/2023, 5:19 PM
Yes, it’s probably due to Pulumi’s default Azure API version being too old. In this case, it’s 2020-12-01. AppServiceEnvironment in the latest stable API version seems to be v3. We’re aware that API versions are not documented right now in the azure native provider and we’re working on it.
e

enough-caravan-98871

02/02/2023, 5:26 PM
Is there a way for me to specify which MS API is used? Forgive me for being the newbie. I am coming over from Terraform. There are many things I like better in Pulumi but this is one that I am struggling with. Should my mindset be to use classic for while dabbling in native understanding that it is less developed? I thought the point of native is to get the latest. I think it my confusion or issue and there is something to learn here.
f

fresh-summer-65887

02/02/2023, 5:27 PM
What platform/lang are you using?
e

enough-caravan-98871

02/02/2023, 5:27 PM
TS
f

fresh-summer-65887

02/02/2023, 5:30 PM
Prob something like
import * as foo from "@pulumi/azure-native/foo/v20220301";
at the top of your file.
where
foo
is whatever service
(That's just a guess, I haven't tried it)
m

melodic-tomato-39005

02/02/2023, 5:31 PM
Native is stable and fully supported. The only issue is that these API version imports are not very discoverable right now.
e

enough-caravan-98871

02/02/2023, 5:32 PM
Understood. I will play with that and thank you!
f

fresh-summer-65887

02/02/2023, 5:32 PM
Yeah I totally found them by accident recently 🙂 (Doing azure stuff, have been traditionally AWS).
I needed to do same to set up
standard
tier front door cdn.
e

enough-caravan-98871

02/02/2023, 7:47 PM
My issue did not end up being the API version after all. I just needed to specify kind: "ASEV3". Otherwise, it was creating a ASEV1 by default. This is another thing that I am struggling with. The 'possible' values of properties are not well documented, so we have to go search them out.
I hope to continue learning my way around, so I can contribute more and complain less. 🤣
i

incalculable-napkin-4298

02/03/2023, 6:48 AM
I find myself 'by default' using the latest version of the api's. Some versions only support parts of the api surface though, so then I downgrade. As for documentation, I usually refer to the Microsoft ARM template documentation, only using the pulumi docs to get started with something.
If you stick with the 'default' namespaced versions, you'll get warnings from Microsoft that they will be depricated soon AND a not all the functionality is available.
m

melodic-tomato-39005

02/03/2023, 2:44 PM
We’ve let the default versions get a bit too old. We’re working on bumping them all up currently, although that’ll be a breaking change for users relying on the current default versions, so it’ll be a major version bump.
e

enough-caravan-98871

02/03/2023, 2:50 PM
@melodic-tomato-39005 Regarding Pulumi documentation, have you considered having an API version toggle like MS has for their dev documentation? That would be a great feature request I guess. With that, you would essentially document whatever default API version Pulumi is using in the current version but on toggle to a different version, provide documentation for how to utilize that version and any changes or additions in properties across different API versions.
m

melodic-tomato-39005

02/03/2023, 2:51 PM
Yep, for sure. Unfortunately, the size of the Azure docs makes it a bit harder than just adding a toggle, but it’s pretty high up in our plans.