Skip to content

Commit

Permalink
Create README for App Configuration sample
Browse files Browse the repository at this point in the history
  • Loading branch information
nickzhums committed Sep 17, 2020
1 parent 90d4c52 commit 82db6ca
Showing 1 changed file with 122 additions and 0 deletions.
122 changes: 122 additions & 0 deletions samples/appconfiguration/create-app-configuration/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,122 @@
---
page_type: sample
languages:
- csharp
products:
- azure
description: "This code samples will show you how to create an App Configuration using Azure SDK for .NET."
urlFragment: appconfiguration-create-appconfiguration
---
# Getting started - Creating App Configurations using Azure .NET SDK

This code sample will show you how to create an App Configuration using Azure SDK for .NET.

## Features

This project framework provides examples for the following services:

### EventHub
* You can find the details for the library [here](https://azure.github.io/azure-sdk/releases/latest/#dotnet).

## Getting Started

### Prerequisites

You will need the following values to authenticate to Azure

- **Subscription ID**
- **Client ID**
- **Client Secret**
- **Tenant ID**

These values can be obtained from the portal, here's the instructions:

### Get Subscription ID

1. Login into your Azure account
2. Select Subscriptions in the left sidebar
3. Select whichever subscription is needed
4. Click on Overview
5. Copy the Subscription ID

### Get Client ID / Client Secret / Tenant ID

For information on how to get Client ID, Client Secret, and Tenant ID,
please refer to [this
document](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal)

### Setting Environment Variables

After you obtained the values, you need to set the following values as
your environment variables

- `AZURE_CLIENT_ID`
- `AZURE_CLIENT_SECRET`
- `AZURE_TENANT_ID`
- `AZURE_SUBSCRIPTION_ID`

To set the following environment variables on your development system:

Windows (Note: Administrator access is required)

1. Open the Control Panel
2. Click System Security, then System
3. Click Advanced system settings on the left
4. Inside the System Properties window, click the Environment
Variables… button.
5. Click on the property you would like to change, then click the Edit…
button. If the property name is not listed, then click the New…
button.

Linux-based OS :

export AZURE_CLIENT_ID="__CLIENT_ID__"
export AZURE_CLIENT_SECRET="__CLIENT_SECRET__"
export AZURE_TENANT_ID="__TENANT_ID__"
export AZURE_SUBSCRIPTION_ID="__SUBSCRIPTION_ID__"

### Installation

To complete this tutorial:

* Install .NET Core latest version for [Linux] or [Windows]

If you don't have an Azure subscription, create a [free account] before you begin.

### Quickstart

1. Clone the repository on your machine:

```bash
git clone https://github.com/Azure-Samples/azure-samples-net-management.git
```

2. Switch to the project folder:
```bash
cd samples/appconfiguration/create-app-configuration
```

3. Run the application with the `dotnet run` command.

```console
dotnet run
```

## This sample shows how to create an App Configuration

## More information

The [Azure Compute documentation] includes a rich set of tutorials and conceptual articles, which serve as a good complement to the samples.

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

<!-- LINKS -->
[Linux]: https://dotnet.microsoft.com/download
[Windows]: https://dotnet.microsoft.com/download
[free account]: https://azure.microsoft.com/free/?WT.mc_id=A261C142F
[Azure Portal]: https://portal.azure.com
[Azure Compute documentation]: https://docs.microsoft.com/azure/?product=compute
[Microsoft Open Source Code of Conduct]: https://opensource.microsoft.com/codeofconduct/
[Code of Conduct FAQ]: https://opensource.microsoft.com/codeofconduct/faq/
[opencode@microsoft.com]: mailto:opencode@microsoft.com

0 comments on commit 82db6ca

Please sign in to comment.