mirror of https://github.com/dapr/quickstarts.git
81 lines
2.1 KiB
Markdown
81 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:
|
|
|
|
- Node 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. Navigate to folder and install dependencies:
|
|
|
|
<!-- STEP
|
|
name: Install Node dependencies
|
|
-->
|
|
|
|
```bash
|
|
cd ./order-processor
|
|
npm install
|
|
```
|
|
|
|
<!-- END_STEP -->
|
|
|
|
1. Run the Node app with Dapr:
|
|
|
|
<!-- STEP
|
|
name: Run order-processor service
|
|
expected_stdout_lines:
|
|
- '== APP == Configuration for orderId2: {"key":"orderId2","value":'
|
|
- '== APP == App unsubscribed to config changes'
|
|
- "Exited App successfully"
|
|
expected_stderr_lines:
|
|
output_match_mode: substring
|
|
match_order: none
|
|
sleep: 120
|
|
-->
|
|
|
|
```bash
|
|
cd ./order-processor
|
|
dapr run --app-id order-processor --resources-path ../../../components/ --app-protocol grpc --dapr-grpc-port 3500 -- node index.js
|
|
```
|
|
|
|
<!-- 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 -->
|