45 lines
2.1 KiB
Markdown
45 lines
2.1 KiB
Markdown
|
# gRPC сервер
|
|||
|
|
|
|||
|
|
Пример gRPC сервера, реализующего 2 rpc: положить и получить значение.
|
|||
|
|
|
|||
|
|
В env переменной `SERVER_ADDR` передается адрес и порт, которые будет "слушать" сервер.
|
|||
|
|
Если переменная не задана, используется параметр по умолчанию — `0.0.0.0:51000`.
|
|||
|
|
|
|||
|
|
## protobuf
|
|||
|
|
|
|||
|
|
protobuf спецификация хранится в [storage.proto](./proto/storage.proto).
|
|||
|
|
Для перегенерации *pb.go-файлов, необходимо в корне проекта вызвать protoc:
|
|||
|
|
```bash
|
|||
|
|
protoc --go_out=. --go_opt=paths=source_relative \
|
|||
|
|
--go-grpc_out=. --go-grpc_opt=paths=source_relative \
|
|||
|
|
proto/storage.proto
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Подробнее о gRPC можно узнать в [документации](https://grpc.io/docs/languages/go/basics/) (там же есть блок про stream'ы). С более сложным примером proto-файла можно ознакомиться [здесь](https://github.com/paralin/raft-grpc/blob/master/raft-grpc.proto).
|
|||
|
|
|
|||
|
|
## Тестирование
|
|||
|
|
|
|||
|
|
Сервер можно запустить с помощью команды `go run main.go`.
|
|||
|
|
|
|||
|
|
Подключиться к серверу можно с помощью [grpcurl](https://github.com/fullstorydev/grpcurl):
|
|||
|
|
```bash
|
|||
|
|
# Установить значение 100500
|
|||
|
|
grpcurl -d '{"value": {"payload": 100500}}' -plaintext localhost:51000 storage.Storage/PutValue
|
|||
|
|
|
|||
|
|
# Получить актуальное значение
|
|||
|
|
grpcurl -d '{}' -plaintext localhost:51000 storage.Storage/GetValue
|
|||
|
|
```
|
|||
|
|
## Docker
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# Собрать Docker образ с сервером
|
|||
|
|
docker build -t hse-grpc-server .
|
|||
|
|
|
|||
|
|
# Запустить Docker контейнер:
|
|||
|
|
# -d - запуск в фоне
|
|||
|
|
# -p 50000:51000 - проброс портов: по порту 50000 с хоста будет доступен порт 51000 из контейнера
|
|||
|
|
docker run -d -p 50000:51000 hse-grpc-server
|
|||
|
|
|
|||
|
|
docker ps
|
|||
|
|
docker stop CONTAINER_ID
|
|||
|
|
```
|