Add week 2 materials

2026-09-14 14:45:31 +03:00
parent e29c7eb39e
commit 73a65e0855
34 changed files with 1824 additions and 0 deletions
@@ -0,0 +1,45 @@
+# gRPC сервер
+
+Пример gRPC сервера, реализующего 2 rpc: положить и получить значение.
+
+В env переменной `SERVER_ADDR` передается адрес и порт, которые будет "слушать" сервер.
+Если переменная не задана, используется параметр по умолчанию &mdash; `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
+```