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

K8s-runtime SDK #45651

Merged
merged 27 commits into from
Oct 17, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
6 changes: 6 additions & 0 deletions .github/CODEOWNERS
Validating CODEOWNERS rules …
Original file line number Diff line number Diff line change
Expand Up @@ -967,6 +967,12 @@
# PRLabel: %Communication - Resource Manager
/sdk/communication/Azure.ResourceManager.Communication/ @archerzz @ArcturusZhang @ArthurMa1978

# PRLael: %Container Orchestrator Runtime
HE-Xinyu marked this conversation as resolved.
Show resolved Hide resolved
/sdk/containerorchestratorruntime/Azure.ResourceManager.*/ @HE-Xinyu @ddadaal

# ServiceLabel: %Container Orchestrator Runtime
# ServiceOwners: @HE-Xinyu @ddadaal

# PRLabel: %Device Registry
/sdk/deviceregistry/Azure.ResourceManager.DeviceRegistry/ @davidemontanari @atastrophic @marcodalessandro @rohankhandelwal @riteshrao

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@

Microsoft Visual Studio Solution File, Format Version 12.00
# Visual Studio Version 16
VisualStudioVersion = 16.0.30309.148
MinimumVisualStudioVersion = 10.0.40219.1
Project("{9F6E69E7-B27E-43EA-AC7D-D33ACA837984}") = "Azure.ResourceManager.ContainerOrchestratorRuntime", "src\Azure.ResourceManager.ContainerOrchestratorRuntime.csproj", "{0AA87EFC-F071-4EF8-AD4A-7BA7E2BF197B}"
EndProject
Project("{9F6E69E7-B27E-43EA-AC7D-D33ACA837984}") = "Azure.ResourceManager.ContainerOrchestratorRuntime.Tests", "tests\Azure.ResourceManager.ContainerOrchestratorRuntime.Tests.csproj", "{C0214FC2-88F7-400E-B1EA-DB294F675623}"
EndProject
Project("{9F6E69E7-B27E-43EA-AC7D-D33ACA837984}") = "Azure.ResourceManager.ContainerOrchestratorRuntime.Samples", "samples\Azure.ResourceManager.ContainerOrchestratorRuntime.Samples.csproj", "{ED2FB799-83E0-4781-A91E-064B30DC641B}"
EndProject
Global
GlobalSection(SolutionProperties) = preSolution
HideSolutionNode = FALSE
EndGlobalSection
GlobalSection(ExtensibilityGlobals) = postSolution
SolutionGuid = {60D44954-F0BF-41F4-AA5B-D89A885131B0}
EndGlobalSection
GlobalSection(SolutionConfigurationPlatforms) = preSolution
Debug|Any CPU = Debug|Any CPU
Debug|x64 = Debug|x64
Debug|x86 = Debug|x86
Release|Any CPU = Release|Any CPU
Release|x64 = Release|x64
Release|x86 = Release|x86
EndGlobalSection
GlobalSection(ProjectConfigurationPlatforms) = postSolution
{0AA87EFC-F071-4EF8-AD4A-7BA7E2BF197B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{0AA87EFC-F071-4EF8-AD4A-7BA7E2BF197B}.Debug|Any CPU.Build.0 = Debug|Any CPU
{0AA87EFC-F071-4EF8-AD4A-7BA7E2BF197B}.Debug|x64.ActiveCfg = Debug|Any CPU
{0AA87EFC-F071-4EF8-AD4A-7BA7E2BF197B}.Debug|x64.Build.0 = Debug|Any CPU
{0AA87EFC-F071-4EF8-AD4A-7BA7E2BF197B}.Debug|x86.ActiveCfg = Debug|Any CPU
{0AA87EFC-F071-4EF8-AD4A-7BA7E2BF197B}.Debug|x86.Build.0 = Debug|Any CPU
{0AA87EFC-F071-4EF8-AD4A-7BA7E2BF197B}.Release|Any CPU.ActiveCfg = Release|Any CPU
{0AA87EFC-F071-4EF8-AD4A-7BA7E2BF197B}.Release|Any CPU.Build.0 = Release|Any CPU
{0AA87EFC-F071-4EF8-AD4A-7BA7E2BF197B}.Release|x64.ActiveCfg = Release|Any CPU
{0AA87EFC-F071-4EF8-AD4A-7BA7E2BF197B}.Release|x64.Build.0 = Release|Any CPU
{0AA87EFC-F071-4EF8-AD4A-7BA7E2BF197B}.Release|x86.ActiveCfg = Release|Any CPU
{0AA87EFC-F071-4EF8-AD4A-7BA7E2BF197B}.Release|x86.Build.0 = Release|Any CPU
{C0214FC2-88F7-400E-B1EA-DB294F675623}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{C0214FC2-88F7-400E-B1EA-DB294F675623}.Debug|Any CPU.Build.0 = Debug|Any CPU
{C0214FC2-88F7-400E-B1EA-DB294F675623}.Debug|x64.ActiveCfg = Debug|Any CPU
{C0214FC2-88F7-400E-B1EA-DB294F675623}.Debug|x64.Build.0 = Debug|Any CPU
{C0214FC2-88F7-400E-B1EA-DB294F675623}.Debug|x86.ActiveCfg = Debug|Any CPU
{C0214FC2-88F7-400E-B1EA-DB294F675623}.Debug|x86.Build.0 = Debug|Any CPU
{C0214FC2-88F7-400E-B1EA-DB294F675623}.Release|Any CPU.ActiveCfg = Release|Any CPU
{C0214FC2-88F7-400E-B1EA-DB294F675623}.Release|Any CPU.Build.0 = Release|Any CPU
{C0214FC2-88F7-400E-B1EA-DB294F675623}.Release|x64.ActiveCfg = Release|Any CPU
{C0214FC2-88F7-400E-B1EA-DB294F675623}.Release|x64.Build.0 = Release|Any CPU
{C0214FC2-88F7-400E-B1EA-DB294F675623}.Release|x86.ActiveCfg = Release|Any CPU
{C0214FC2-88F7-400E-B1EA-DB294F675623}.Release|x86.Build.0 = Release|Any CPU
{ED2FB799-83E0-4781-A91E-064B30DC641B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{ED2FB799-83E0-4781-A91E-064B30DC641B}.Debug|Any CPU.Build.0 = Debug|Any CPU
{ED2FB799-83E0-4781-A91E-064B30DC641B}.Debug|x64.ActiveCfg = Debug|Any CPU
{ED2FB799-83E0-4781-A91E-064B30DC641B}.Debug|x64.Build.0 = Debug|Any CPU
{ED2FB799-83E0-4781-A91E-064B30DC641B}.Debug|x86.ActiveCfg = Debug|Any CPU
{ED2FB799-83E0-4781-A91E-064B30DC641B}.Debug|x86.Build.0 = Debug|Any CPU
{ED2FB799-83E0-4781-A91E-064B30DC641B}.Release|Any CPU.ActiveCfg = Release|Any CPU
{ED2FB799-83E0-4781-A91E-064B30DC641B}.Release|Any CPU.Build.0 = Release|Any CPU
{ED2FB799-83E0-4781-A91E-064B30DC641B}.Release|x64.ActiveCfg = Release|Any CPU
{ED2FB799-83E0-4781-A91E-064B30DC641B}.Release|x64.Build.0 = Release|Any CPU
{ED2FB799-83E0-4781-A91E-064B30DC641B}.Release|x86.ActiveCfg = Release|Any CPU
{ED2FB799-83E0-4781-A91E-064B30DC641B}.Release|x86.Build.0 = Release|Any CPU
EndGlobalSection
EndGlobal
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# Release History

## 1.0.0-beta.1 (2024-10-18)

### Features Added

This package follows the [new Azure SDK guidelines](https://azure.github.io/azure-sdk/general_introduction.html), and provides many core capabilities:

- Support MSAL.NET, Azure.Identity is out of box for supporting MSAL.NET.
- Support [OpenTelemetry](https://opentelemetry.io/) for distributed tracing.
- HTTP pipeline with custom policies.
- Better error-handling.
- Support uniform telemetry across all languages.

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).

> 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).
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<!--
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
-->
<Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory).., Directory.Build.props))\Directory.Build.props" />
</Project>
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
# Microsoft Azure Container Orchestrator Runtime management client library for .NET

AKS on Azure Stack HCI 23H2 uses Azure Arc to create new Kubernetes clusters on Azure Stack HCI directly from Azure. It enables you to use familiar tools like the Azure portal, Azure CLI, and Azure Resource Manager templates to create and manage your Kubernetes clusters running on Azure Stack HCI. Since clusters are automatically connected to Arc when they are created, you can use your Microsoft Entra ID for connecting to your clusters from anywhere. This ensures your developers and application operators can provision and configure Kubernetes clusters in accordance with company policies.

This library follows the [new Azure SDK guidelines](https://azure.github.io/azure-sdk/general_introduction.html), and provides many core capabilities:

- Support MSAL.NET, Azure.Identity is out of box for supporting MSAL.NET.
- Support [OpenTelemetry](https://opentelemetry.io/) for distributed tracing.
- HTTP pipeline with custom policies.
- Better error-handling.
- Support uniform telemetry across all languages.

## Getting started

### Install the package

Install the Microsoft Azure Container Orchestrator Runtime management library for .NET with [NuGet](https://www.nuget.org/):

```dotnetcli
dotnet add package Azure.ResourceManager.ContainerOrchestratorRuntime --prerelease
```

### Prerequisites

* You must have an [Microsoft Azure subscription](https://azure.microsoft.com/free/dotnet/).

### Authenticate the Client

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).

## Key concepts

Key concepts of the Microsoft Azure SDK for .NET can be found [here](https://azure.github.io/azure-sdk/dotnet_introduction.html)

## Documentation

Documentation is available to help you learn how to use this package:

- [Quickstart](https://github.com/Azure/azure-sdk-for-net/blob/main/doc/dev/mgmt_quickstart.md).
- [API References](https://docs.microsoft.com/dotnet/api/?view=azure-dotnet).
- [Authentication](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/identity/Azure.Identity/README.md).

## Examples

Code samples for using the management library for .NET can be found in the following locations
- [.NET Management Library Code Samples](https://aka.ms/azuresdk-net-mgmt-samples)

## Troubleshooting

- File an issue via [GitHub Issues](https://github.com/Azure/azure-sdk-for-net/issues).
- Check [previous questions](https://stackoverflow.com/questions/tagged/azure+.net) or ask new ones on Stack Overflow using Azure and .NET tags.

## Next steps

For more information about Microsoft Azure SDK, see [this website](https://azure.github.io/azure-sdk/).

## Contributing

For details on contributing to this repository, see the [contributing
guide][cg].

This project welcomes contributions and suggestions. Most contributions
require you to agree to a Contributor License Agreement (CLA) declaring
that you have the right to, and actually do, grant us the rights to use
your contribution. For details, visit <https://cla.microsoft.com>.

When you submit a pull request, a CLA-bot will automatically determine
whether you need to provide a CLA and decorate the PR appropriately
(for example, label, comment). Follow the instructions provided by the
bot. You'll only need to do this action once across all repositories
using our CLA.

This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For
more information, see the [Code of Conduct FAQ][coc_faq] or contact
<opencode@microsoft.com> with any other questions or comments.

<!-- LINKS -->
[cg]: https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/resourcemanager/Azure.ResourceManager/docs/CONTRIBUTING.md
[coc]: https://opensource.microsoft.com/codeofconduct/
[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
Loading
Loading