The New AddAzureContainerAppEnvironment() - how do I use it?

[essenbee2]

I see that 9.2 introduces AddAzureContainerAppEnvironment(), and I know that in my existing Aspire application system, I am going to have to use the following, because the app system is already deployed via azd:

var builder = DistributionApplicationBuilder.Create(args);

var acaEnv = builder.AddAzureContainerAppEnvironment("aca-env")
                    .WithAzdResourceNaming();

// Omitted for brevity...

builder.Build().Run();

But the // Omitted for brevity... comment is hiding what I do with that acaEnv variable! Do I have to add a Reference to that variable to each of the resources that I want to reside inside that Azure Container Environment? Some clarity is missing from the documentation, so can anyone help provide that clarity here please?

I ask because I am assuming that without adding the above code, my existing azd provisioning will stop working. Isn't that a breaking change just as much as the Managed Identity change is? Or can I just carry on using azd as I am now and not add the AddAzureContainerAppEnvironment() stuff? I would greatly appreciate some clear guidance on this please :-)

Stu

[davidfowl]

But the // Omitted for brevity... comment is hiding what I do with that acaEnv variable! Do I have to add a Reference to that variable to each of the resources that I want to reside inside that Azure Container Environment? Some clarity is missing from the documentation, so can anyone help provide that clarity here please?

You don't need to use that variable anywhere, just calling the method will declare the ACA environment as part of the set of resources the app host "owns" and the compute resources (projects and containers) will "attach" themselves to it.

I ask because I am assuming that without adding the above code, my existing azd provisioning will stop working. Isn't that a breaking change just as much as the Managed Identity change is? Or can I just carry on using azd as I am now and not add the AddAzureContainerAppEnvironment() stuff? I would greatly appreciate some clear guidance on this please :-)

Can you be really clear on what you mean? Are you using the latest version of azd?

cc @IEvangelist

[essenbee2]

Thanks for responding David! I had thought that maybe I had to use the new API, but experiments have shown me that the azd deployment I currently (I am using the latest version of azd, yes) use still works fine in 9.2. I appreciate that I can now try out the new API with the .WithAzdResourceNaming() extension and don't have to worry about creating duplicate resources or having to "wire up" all the container apps (I have lots of them) into the container environment in the App Host. I think I was reading more into the feature than was real, hence my questions.

Cheers,

Stu

[hjrb]

Fully agree. WithAzdResourceNaming is a great extension