mirror of https://github.com/dapr/quickstarts.git
80 lines
2.1 KiB
Markdown
80 lines
2.1 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:
|
|
|
|
- Python 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 Python service with Dapr
|
|
|
|
1. Open a new terminal window and navigate to `order-processor` directory:
|
|
|
|
<!-- STEP
|
|
name: Install python dependencies
|
|
-->
|
|
|
|
```bash
|
|
cd ./order-processor
|
|
pip3 install -r requirements.txt
|
|
```
|
|
|
|
<!-- END_STEP -->
|
|
|
|
2. Run the Python service app with Dapr:
|
|
|
|
<!-- STEP
|
|
name: Run order-processor service
|
|
expected_stdout_lines:
|
|
- '== APP == Configuration for orderId2 : value: "102"'
|
|
- '== APP == Subscription ID is'
|
|
expected_stderr_lines:
|
|
output_match_mode: substring
|
|
match_order: none
|
|
sleep: 15
|
|
-->
|
|
|
|
```bash
|
|
cd ./order-processor
|
|
dapr run --app-id order-processor --resources-path ../../../components/ --app-port 6001 -- python3 app.py
|
|
```
|
|
|
|
<!-- 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 -->
|