Перейти к основному содержимому

7. Итоговая работа: небольшое приложение NATS

Это итоговая работа: небольшое приложение, которое объединяет всё из предыдущих руководств. Оно подключается к NATS, публикует события заказов в поток JetStream и отвечает на запрос о числе учтённых заказов. Запустите его и посмотрите, как вместе работают три шаблона: публикация и подписка, запрос и ответ и поток, сохраняющий ваши сообщения.

Что понадобится​

  • Установленные nats-server и CLI nats (Руководство 1: Привет, NATS).
  • Среда выполнения языка, выбранного во вкладке клиента (Go, Node.js, Python и другие).
  • Около 15 минут. Понадобятся три терминала.

Шаг 1: запустите сервер JetStream​

В первом терминале запустите сервер с включённым JetStream, чтобы он мог сохранять поток:

nats-server -js

В журнале запуска должна быть строка с упоминанием JetStream:

[INF] Starting nats-server
[INF] Starting JetStream
[INF] Server is ready

Оставьте этот терминал работающим.

Шаг 2: создайте поток​

Откройте второй терминал. Создайте поток ORDERS, сохраняющий все сообщения, опубликованные в темы, соответствующие orders.>:

#!/bin/bash
# Создайте поток ORDERS, принимающий каждое событие заказа, которое приложение
# публикует. Поток хранит все сообщения в темах orders.>
# и сохраняет их между запусками.
nats stream add ORDERS \
--subjects "orders.>" \
--storage file \
--defaults

Должно появиться подтверждение с описанием нового потока:

Stream ORDERS was created

Subjects: orders.>
Storage: File

Шаг 3: напишите и запустите приложение​

Теперь напишите само приложение. Оно подключается к NATS, публикует в поток три события заказа, затем подписывается на app.orders.count и отвечает на запросы текущим числом опубликованных заказов. Тема запросов намеренно находится за пределами orders.>: запрос в тему из orders.> сохранился бы в потоке, и подтверждение сохранения от потока пришло бы раньше ответа приложения.

Сохраните код для выбранного языка в одном файле, затем установите зависимости и запустите его во втором терминале:

package main

import (
"context"
"fmt"
"time"

"github.com/nats-io/nats.go"
"github.com/nats-io/nats.go/jetstream"
)

func main() {
// Подключиться к серверу, запущенному на шаге 1.
nc, _ := nats.Connect(nats.DefaultURL)
defer nc.Drain()

js, _ := jetstream.New(nc)
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()

// Опубликовать три события заказов в поток ORDERS.
orders := []string{"orders.created", "orders.created", "orders.shipped"}
for _, subject := range orders {
js.Publish(ctx, subject, []byte("event"))
}
count := len(orders)
fmt.Printf("published %d order events\n", count)

// Отвечать на запросы app.orders.count текущим общим количеством.
nc.Subscribe("app.orders.count", func(msg *nats.Msg) {
msg.Respond([]byte(fmt.Sprintf("%d orders", count)))
})

fmt.Println("ready: send a request to app.orders.count")
select {} // keep running so it can answer requests
}

Сохраните код как main.go, затем настройте модуль и запустите:

go mod init orders-app
go get github.com/nats-io/nats.go
go run main.go

Приложение должно вывести ход выполнения и перейти в ожидание:

published 3 order events
ready: send a request to app.orders.count

Оставьте приложение работающим.

Шаг 4: убедитесь, что события попали в поток​

Откройте третий терминал. Прочитайте сообщения, сохранённые приложением в потоке ORDERS:

#!/bin/bash
# Покажите сообщения, опубликованные приложением в поток ORDERS. Каждое событие
# заказа сохранено в потоке и доступно для чтения.
nats stream view ORDERS

Вы должны увидеть три опубликованных события заказа, каждое в своей теме:

[1] Subject: orders.created
[2] Subject: orders.created
[3] Subject: orders.shipped

Теперь события находятся в потоке и готовы к чтению потребителем:

Шаг 5: задайте приложению вопрос​

В том же третьем терминале отправьте приложению запрос в тему app.orders.count:

#!/bin/bash
# Запросите у работающего приложения количество полученных заказов. Оно подписано на
# app.orders.count и отвечает текущим общим количеством, поэтому запрос возвращает
# одно ответное сообщение.
nats request app.orders.count ""

Вы должны сразу получить ответ приложения:

3 orders

Готово: приложение ответило на запрос числом опубликованных им заказов.

Что вы создали​

Одно приложение, которое подключается к NATS, публикует события заказов в долговременный поток и отвечает на запрос текущим вычисленным итогом. Публикация и подписка, JetStream и запрос-ответ работают вместе в одной программе.

Дальше​

Вы завершили практические руководства. Чтобы понять, почему каждый компонент работает именно так, переходите к углублённым курсам: