mirror of https://github.com/dapr/quickstarts.git
67 lines
2.0 KiB
Markdown
67 lines
2.0 KiB
Markdown
# Dapr Configuration API
|
|
|
|
In this quickstart, you'll create a microservice which makes use of Dapr's Configuration API. Configuration items are key/value pairs containing configuration data such as app ids, partition keys, database names etc. The service gets configuration items from the configuration store and subscribes for configuration updates.
|
|
|
|
Visit [this](https://docs.dapr.io/developing-applications/building-blocks/configuration/) link for more information about Dapr and Configuration API.
|
|
|
|
This quickstart includes one service:
|
|
|
|
- Dotnet service `order-processor`
|
|
|
|
## Add configuration items to the config store
|
|
|
|
### Prerequisite
|
|
|
|
- Locally running redis container - a redis container named `dapr_redis` is automatically created when you run `dapr init`
|
|
- Open a new terminal and set values for config items `orderId1` and `orderId2` by using the command below
|
|
|
|
<!-- STEP
|
|
name: Add configuration items
|
|
expected_stdout_lines:
|
|
- 'OK'
|
|
-->
|
|
|
|
```bash
|
|
docker exec dapr_redis redis-cli MSET orderId1 "101" orderId2 "102"
|
|
```
|
|
|
|
<!-- END_STEP -->
|
|
|
|
## Run order-processor
|
|
|
|
1. Open a new terminal and navigate to `order-processor` directory.
|
|
2. Run the service app with Dapr.
|
|
|
|
<!-- STEP
|
|
name: Run order-processor service
|
|
expected_stdout_lines:
|
|
- '== APP == Configuration for orderId2: {"Value":"102","Version":"","Metadata":{}}'
|
|
- '== APP == App subscribed to config changes with subscription id:'
|
|
expected_stderr_lines:
|
|
output_match_mode: substring
|
|
match_order: none
|
|
sleep: 15
|
|
-->
|
|
|
|
```bash
|
|
cd ./order-processor
|
|
dapr run --app-id order-processor-http --resources-path ../../../components/ --app-port 7007 -- dotnet run --project .
|
|
```
|
|
|
|
<!-- END_STEP -->
|
|
|
|
## (Optional) Update value of config items
|
|
|
|
1. Keep the `order-processor` app running and open a separate terminal
|
|
2. Change the values of `orderId1` and `orderId2` using the command below
|
|
3. `order-processor` app gets the updated values of config items
|
|
|
|
<!-- STEP
|
|
name: Update config items
|
|
-->
|
|
|
|
```bash
|
|
docker exec dapr_redis redis-cli MSET orderId1 "103" orderId2 "104"
|
|
```
|
|
|
|
<!--END_STEP --> |