Skip to content

Commit 989e124

Browse files
gerrytangerrytan
authored
New SDK: Azure.ResourceManager.Terraform (Azure#46301)
1 parent 5ac4063 commit 989e124

File tree

49 files changed

+3992
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

49 files changed

+3992
-0
lines changed

‎sdk/resourcemanager/ci.mgmt.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -194,6 +194,7 @@ trigger:
194194
- sdk/subscription/Azure.ResourceManager.Subscription
195195
- sdk/support/Azure.ResourceManager.Support
196196
- sdk/synapse/Azure.ResourceManager.Synapse
197+
- sdk/terraform/Azure.ResourceManager.Terraform
197198
- sdk/trafficmanager/Azure.ResourceManager.TrafficManager
198199
- sdk/trustedsigning/Azure.ResourceManager.TrustedSigning
199200
- sdk/voiceservices/Azure.ResourceManager.VoiceServices
@@ -397,6 +398,7 @@ pr:
397398
- sdk/subscription/Azure.ResourceManager.Subscription
398399
- sdk/support/Azure.ResourceManager.Support
399400
- sdk/synapse/Azure.ResourceManager.Synapse
401+
- sdk/terraform/Azure.ResourceManager.Terraform
400402
- sdk/trafficmanager/Azure.ResourceManager.TrafficManager
401403
- sdk/trustedsigning/Azure.ResourceManager.TrustedSigning
402404
- sdk/voiceservices/Azure.ResourceManager.VoiceServices

‎sdk/terraform/Azure.ResourceManager.Terraform/Azure.ResourceManager.Terraform.sln‎

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
2+
Microsoft Visual Studio Solution File, Format Version 12.00
3+
# Visual Studio Version 16
4+
VisualStudioVersion = 16.0.30309.148
5+
MinimumVisualStudioVersion = 10.0.40219.1
6+
Project("{57104F4E-33D2-4712-89D0-35A4165C1BA1}") = "Azure.ResourceManager.Terraform", "src\Azure.ResourceManager.Terraform.csproj", "{3457A0A4-B5E1-4184-8D42-0F1C542217C9}"
7+
EndProject
8+
Project("{57104F4E-33D2-4712-89D0-35A4165C1BA1}") = "Azure.ResourceManager.Terraform.Tests", "tests\Azure.ResourceManager.Terraform.Tests.csproj", "{DC07DC97-58C7-4345-B915-29DF7739ABD5}"
9+
EndProject
10+
Project("{57104F4E-33D2-4712-89D0-35A4165C1BA1}") = "Azure.ResourceManager.Terraform.Samples", "samples\Azure.ResourceManager.Terraform.Samples.csproj", "{0C87CC4B-8863-41FC-8704-20CC6F8A58E1}"
11+
EndProject
12+
Global
13+
GlobalSection(SolutionProperties) = preSolution
14+
HideSolutionNode = FALSE
15+
EndGlobalSection
16+
GlobalSection(ExtensibilityGlobals) = postSolution
17+
SolutionGuid = {79ECAB3D-FE5F-4AF2-9214-2D6F13CB7F9C}
18+
EndGlobalSection
19+
GlobalSection(SolutionConfigurationPlatforms) = preSolution
20+
Debug|Any CPU = Debug|Any CPU
21+
Debug|x64 = Debug|x64
22+
Debug|x86 = Debug|x86
23+
Release|Any CPU = Release|Any CPU
24+
Release|x64 = Release|x64
25+
Release|x86 = Release|x86
26+
EndGlobalSection
27+
GlobalSection(ProjectConfigurationPlatforms) = postSolution
28+
{3457A0A4-B5E1-4184-8D42-0F1C542217C9}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
29+
{3457A0A4-B5E1-4184-8D42-0F1C542217C9}.Debug|Any CPU.Build.0 = Debug|Any CPU
30+
{3457A0A4-B5E1-4184-8D42-0F1C542217C9}.Debug|x64.ActiveCfg = Debug|Any CPU
31+
{3457A0A4-B5E1-4184-8D42-0F1C542217C9}.Debug|x64.Build.0 = Debug|Any CPU
32+
{3457A0A4-B5E1-4184-8D42-0F1C542217C9}.Debug|x86.ActiveCfg = Debug|Any CPU
33+
{3457A0A4-B5E1-4184-8D42-0F1C542217C9}.Debug|x86.Build.0 = Debug|Any CPU
34+
{3457A0A4-B5E1-4184-8D42-0F1C542217C9}.Release|Any CPU.ActiveCfg = Release|Any CPU
35+
{3457A0A4-B5E1-4184-8D42-0F1C542217C9}.Release|Any CPU.Build.0 = Release|Any CPU
36+
{3457A0A4-B5E1-4184-8D42-0F1C542217C9}.Release|x64.ActiveCfg = Release|Any CPU
37+
{3457A0A4-B5E1-4184-8D42-0F1C542217C9}.Release|x64.Build.0 = Release|Any CPU
38+
{3457A0A4-B5E1-4184-8D42-0F1C542217C9}.Release|x86.ActiveCfg = Release|Any CPU
39+
{3457A0A4-B5E1-4184-8D42-0F1C542217C9}.Release|x86.Build.0 = Release|Any CPU
40+
{DC07DC97-58C7-4345-B915-29DF7739ABD5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
41+
{DC07DC97-58C7-4345-B915-29DF7739ABD5}.Debug|Any CPU.Build.0 = Debug|Any CPU
42+
{DC07DC97-58C7-4345-B915-29DF7739ABD5}.Debug|x64.ActiveCfg = Debug|Any CPU
43+
{DC07DC97-58C7-4345-B915-29DF7739ABD5}.Debug|x64.Build.0 = Debug|Any CPU
44+
{DC07DC97-58C7-4345-B915-29DF7739ABD5}.Debug|x86.ActiveCfg = Debug|Any CPU
45+
{DC07DC97-58C7-4345-B915-29DF7739ABD5}.Debug|x86.Build.0 = Debug|Any CPU
46+
{DC07DC97-58C7-4345-B915-29DF7739ABD5}.Release|Any CPU.ActiveCfg = Release|Any CPU
47+
{DC07DC97-58C7-4345-B915-29DF7739ABD5}.Release|Any CPU.Build.0 = Release|Any CPU
48+
{DC07DC97-58C7-4345-B915-29DF7739ABD5}.Release|x64.ActiveCfg = Release|Any CPU
49+
{DC07DC97-58C7-4345-B915-29DF7739ABD5}.Release|x64.Build.0 = Release|Any CPU
50+
{DC07DC97-58C7-4345-B915-29DF7739ABD5}.Release|x86.ActiveCfg = Release|Any CPU
51+
{DC07DC97-58C7-4345-B915-29DF7739ABD5}.Release|x86.Build.0 = Release|Any CPU
52+
{0C87CC4B-8863-41FC-8704-20CC6F8A58E1}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
53+
{0C87CC4B-8863-41FC-8704-20CC6F8A58E1}.Debug|Any CPU.Build.0 = Debug|Any CPU
54+
{0C87CC4B-8863-41FC-8704-20CC6F8A58E1}.Debug|x64.ActiveCfg = Debug|Any CPU
55+
{0C87CC4B-8863-41FC-8704-20CC6F8A58E1}.Debug|x64.Build.0 = Debug|Any CPU
56+
{0C87CC4B-8863-41FC-8704-20CC6F8A58E1}.Debug|x86.ActiveCfg = Debug|Any CPU
57+
{0C87CC4B-8863-41FC-8704-20CC6F8A58E1}.Debug|x86.Build.0 = Debug|Any CPU
58+
{0C87CC4B-8863-41FC-8704-20CC6F8A58E1}.Release|Any CPU.ActiveCfg = Release|Any CPU
59+
{0C87CC4B-8863-41FC-8704-20CC6F8A58E1}.Release|Any CPU.Build.0 = Release|Any CPU
60+
{0C87CC4B-8863-41FC-8704-20CC6F8A58E1}.Release|x64.ActiveCfg = Release|Any CPU
61+
{0C87CC4B-8863-41FC-8704-20CC6F8A58E1}.Release|x64.Build.0 = Release|Any CPU
62+
{0C87CC4B-8863-41FC-8704-20CC6F8A58E1}.Release|x86.ActiveCfg = Release|Any CPU
63+
{0C87CC4B-8863-41FC-8704-20CC6F8A58E1}.Release|x86.Build.0 = Release|Any CPU
64+
EndGlobalSection
65+
EndGlobal

‎sdk/terraform/Azure.ResourceManager.Terraform/CHANGELOG.md‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# Release History
2+
3+
## 1.0.0-beta.1 (2024-10-31)
4+
5+
### Features Added
6+
7+
This package follows the [new Azure SDK guidelines](https://azure.github.io/azure-sdk/general_introduction.html), and provides many core capabilities:
8+
9+
- Support MSAL.NET, Azure.Identity is out of box for supporting MSAL.NET.
10+
- Support [OpenTelemetry](https://opentelemetry.io/) for distributed tracing.
11+
- HTTP pipeline with custom policies.
12+
- Better error-handling.
13+
- Support uniform telemetry across all languages.
14+
15+
This package is a Public Preview version, so expect incompatible changes in subsequent releases as we improve the product. To provide feedback, submit an issue in our [Azure SDK for .NET GitHub repo](https://github.com/Azure/azure-sdk-for-net/issues).
16+
17+
> NOTE: For more information about unified authentication, please refer to [Microsoft Azure Identity documentation for .NET](https://docs.microsoft.com//dotnet/api/overview/azure/identity-readme?view=azure-dotnet).

‎sdk/terraform/Azure.ResourceManager.Terraform/Directory.Build.props‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
2+
<!--
3+
Add any shared properties you want for the projects under this package directory that need to be set before the auto imported Directory.Build.props
4+
-->
5+
<Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory).., Directory.Build.props))\Directory.Build.props" />
6+
</Project>

‎sdk/terraform/Azure.ResourceManager.Terraform/README.md‎

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
# Microsoft Azure terraform management client library for .NET
2+
3+
The Azure Terraform Export API aims to export existing Azure resources into its equivalent Terraform configurations,
4+
for either azurerm provider or azapi provider. It is equivalent to ARM Template Export API for Terraform.
5+
6+
This library follows the [new Azure SDK guidelines](https://azure.github.io/azure-sdk/general_introduction.html), and provides many core capabilities:
7+
8+
- Support MSAL.NET, Azure.Identity is out of box for supporting MSAL.NET.
9+
- Support [OpenTelemetry](https://opentelemetry.io/) for distributed tracing.
10+
- HTTP pipeline with custom policies.
11+
- Better error-handling.
12+
- Support uniform telemetry across all languages.
13+
14+
## Getting started
15+
16+
### Install the package
17+
18+
Install the Microsoft Azure terraform management library for .NET with [NuGet](https://www.nuget.org/):
19+
20+
```dotnetcli
21+
dotnet add package Azure.ResourceManager.Terraform --prerelease
22+
```
23+
24+
### Prerequisites
25+
26+
- You must have an [Microsoft Azure subscription](https://azure.microsoft.com/free/dotnet/).
27+
28+
### Authenticate the Client
29+
30+
To create an authenticated client and start interacting with Microsoft Azure resources, see the [quickstart guide here](https://github.com/Azure/azure-sdk-for-net/blob/main/doc/dev/mgmt_quickstart.md).
31+
32+
## Key concepts
33+
34+
Key concepts of the Microsoft Azure SDK for .NET can be found [here](https://azure.github.io/azure-sdk/dotnet_introduction.html)
35+
36+
## Documentation
37+
38+
Documentation is available to help you learn how to use this package:
39+
40+
- [Quickstart](https://github.com/Azure/azure-sdk-for-net/blob/main/doc/dev/mgmt_quickstart.md).
41+
- [API References](https://docs.microsoft.com/dotnet/api/?view=azure-dotnet).
42+
- [Authentication](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/identity/Azure.Identity/README.md).
43+
44+
## Examples
45+
46+
Code samples for using the management library for .NET can be found in the following locations
47+
48+
- [.NET Management Library Code Samples](https://aka.ms/azuresdk-net-mgmt-samples)
49+
50+
## Troubleshooting
51+
52+
- File an issue via [GitHub Issues](https://github.com/Azure/azure-sdk-for-net/issues).
53+
- Check [previous questions](https://stackoverflow.com/questions/tagged/azure+.net) or ask new ones on Stack Overflow using Azure and .NET tags.
54+
55+
## Next steps
56+
57+
For more information about Microsoft Azure SDK, see [this website](https://azure.github.io/azure-sdk/).
58+
59+
## Contributing
60+
61+
For details on contributing to this repository, see the [contributing
62+
guide][cg].
63+
64+
This project welcomes contributions and suggestions. Most contributions
65+
require you to agree to a Contributor License Agreement (CLA) declaring
66+
that you have the right to, and actually do, grant us the rights to use
67+
your contribution. For details, visit <https://cla.microsoft.com>.
68+
69+
When you submit a pull request, a CLA-bot will automatically determine
70+
whether you need to provide a CLA and decorate the PR appropriately
71+
(for example, label, comment). Follow the instructions provided by the
72+
bot. You'll only need to do this action once across all repositories
73+
using our CLA.
74+
75+
This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For
76+
more information, see the [Code of Conduct FAQ][coc_faq] or contact
77+
<[email protected]> with any other questions or comments.
78+
79+
<!-- LINKS -->
80+
[cg]: https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/resourcemanager/Azure.ResourceManager/docs/CONTRIBUTING.md
81+
[coc]: https://opensource.microsoft.com/codeofconduct/
82+
[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/

0 commit comments

Comments
 (0)