Google Cloud Run

Cloud Run — это облачный сервис в GCP, который выполняет программный код упакованный в Docker-контейнер.

Cloud Run тесно интегрируется с другими сервисами GCP:

Artefact Registry — реестр образов для Docker-контейнеров.
Cloud Build — сервис для настройки пайплайнов CI/CD с возможностью сборки образов Docker-контейнеров.

Задание 1

Цель: познакомиться с сервисом Cloud Run.

План работы:

Загрузить на временный облачный сервер файлы с исходным кодом приложения.
Проверить их работоспособность.
Создать веб-приложение (сервис) в Cloud Run для обслуживания запросов пользователей.

Ход работы:

Войдите в https://console.cloud.google.com (далее консоль GCP) с помощью своего Google-аккаунта. При входе в первый раз GCP создаст вам учетную запись. При этом нужно будет выбрать произвольную страну.
Убедитесь, что преподаватель знает ваш Google-аккаунт и пригласил вас в свой проект (далее будем обращаться к нему IMI-SVFU). Откройте почту Gmail, найдите приглашение и примите его.
В консоли GCP выберите проект IMI-SVFU.
Откройте Google Cloud Shell:
Просмотрите список доступных учетных записей:
```
gcloud auth list
```

Выберите свою учетную запись:

gcloud config set account <Ваш Google-аккаунт>

Просмотрите список доступных проектов:
```
gcloud config list project
```
Выберите проект IMI-SVFU в Google Cloud Shell:
```
gcloud config set project imi-svfu
```
Создайте каталог для файлов проекта:
```
mkdir ~/helloworld-python
```
Перейдите в каталог для файлов проекта:
```
cd ~/helloworld-python
```
Создайте файлы с исходным кодом:
```
touch main.py requirements.txt Procfile
```
Откройте файлы в редакторе и вставьте исходный код (текст файлов прилагается ниже):
```
cloudshell edit main.py
cloudshell edit requirements.txt
cloudshell edit Procfile
```
Создайте виртуальное окружение:
```
virtualenv venv
```
Активируйте виртуальное окружение:
```
source venv/bin/activate
```
Установите в виртуальное окружение необходимые библиотеки:
```
pip install -r requirements.txt
```
Запустите приложение в режиме разработки:
```
python main.py
```
Откройте превью в браузере и убедитесь, что код работает (должно появиться сообщение “Hello World!”):
Остановите интерпретатор Python нажав клавишу Ctrl+C
Деактивируйте виртуальное окружение:
```
deactivate
```
Удалите виртуальное окружение:
```
rm -r venv/
```
Выберите регион для развертывания:
```
REGION=europe-north1
```

Запустите развертывание:

gcloud run deploy <ваша фамилия> --source . --platform managed --region $REGION --allow-unauthenticated

Найдите в консоли GCP сервис Cloud Run, найдите свой сервис в списке.
Изучите возможности работы с веб-приложениями (сервисами) в интерфейс консоли GCP.
Найдите URL своего сервиса, откройте его в браузере и проверьте что он работает.

main.py:

from flask import Flask, request

app = Flask(__name__)


@app.get("/")
def hello():
    """Return a friendly HTTP greeting."""
    who = request.args.get("who", default="World")
    return f"Hello {who}!\n"


if __name__ == "__main__":
    # Development only: run "python main.py" and open http://localhost:8080
    # When deploying to Cloud Run, a production-grade WSGI HTTP server,
    # such as Gunicorn, will serve the app.
    app.run(host="localhost", port=8080, debug=True)

requirements.txt:

# https://pypi.org/project/flask
Flask==3.0.2

# https://pypi.org/project/gunicorn
gunicorn==21.2.0

Procfile:

web: gunicorn --bind :$PORT --workers 1 --threads 8 --timeout 0 main:app

Задание 2

Цель: научиться настраивать развертывание в Cloud Run в качестве этапа пайплайна Cloud Build.

План работы:

Загрузить на временный облачный сервер файлы с исходным кодом приложения.
Создать репозиторий в GitHub.
Настроить развертывание сервиса в Cloud Run при коммите в GitHub-репозиторий.
Внести изменения в исходный код и проверить автоматическое развертывание.

Ход работы:

Откройте Google Cloud Shell:
Авторизуйте доступ из Google Cloud Shell:
```
gcloud config set account <Ваш Google-аккаунт>
```
Выберите проект в Google Cloud Shell:
```
gcloud config set project imi-svfu
```

Настройте необходимые в будущем переменные окружения:

REGION=europe-north1
PROJECT_ID=imi-svfu
PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format='value(projectNumber)')

Создайте каталог для файлов проекта:
```
mkdir ~/video-describer-job
```
Перейдите в только что созданный каталог:
```
cd $_
```
Создайте файлы исходного кода приложения:
```
mkdir views
touch package.json app.js Dockerfile views/index.pug
```
Откройте файлы в редакторе и вставьте исходный код (текст файлов прилагается ниже):
```
cloudshell edit package.json
cloudshell edit app.js
cloudshell edit Dockerfile
cloudshell edit views/index.pug
```
Установите библиотеки Node.js:
```
npm install
```
Запустите приложение в режиме разработки:
```
npm run start
```
Откройте превью приложения (оно пока содержит ошибки, поэтому не сохраняет изменения)
Нажмите в Cloud Shell клавишу Ctrl+C чтобы прервать работу приложения
Укажите имя разработчика для сохранения в метаданных коммитов:
```
git config --global user.name "<имя разработчика>"
```
Укажите email разработчика для сохранения в метаданных коммитов:
```
git config --global user.email "<почта разработчика>"
```
Выберите способ аутентификации Git с помощью логина и пароля:
```
git config --global credential.helper cache
```
Создайте локальный репозиторий Git и подготовьте его к работе:
```
git init
```
Переименуйте текущую ветку Git в main:
```
git branch -M main
```
Добавьте каталог node_modules в список игнорируемых в Git:
```
echo node_modules/ >> .gitignore
```
Добавьте изменения в текущем каталоге в индекс для коммита (stage):
```
git add .
```
Сохраните изменения в коммите:
```
git commit -m "Initial commit"
```
Создайте новый репозиторий в GitHub и привяжите HTTPS-ссылку к репозиторию:
```
git remote add origin <https-ссылка на репозиторий>
```
Создайте персональный токен доступа (classic) для GitHub по инструкции (с правом доступа к репозиториям) и используйте его в дальнейшем как пароль для git в командной строке.
Отправьте изменения в центральный репозиторий (используйте имя пользователя в GitHub и ранее созданный персональный токен доступа):
```
git push -u origin main
```
Откройте в консоли GCP сервис Cloud Run.
Нажмите кнопку “DEPLOY CONTAINER → SERVICE” для начала создания сервиса.
Выберите вариант “Continuously deploy from a repository” с логотипом GitHub. Нажмите кнопку “SET UP WITH CLOUD BUILD”.
При необходимости разрешите доступ Cloud Build к GitHub и выберите созданный ранее репозиторий. Нажмите кнопку “NEXT”.
Выберите тип сборки с помощью Dockerfile. Нажмите кнопку “SAVE”.
Введите в качестве имени сервиса свою группу и фамилию.
Выберите регион europe-north1.
Выберите вариант аутентификации пользователей “Allow unauthenticated invocations”.
Оставьте остальные изменения без изменений и нажмите кнопку “CREATE”.
Откройте в браузере URL сервиса и проверьте что сервис отображает сообщение “Hello World!”
Измените сообщение в app.js
Добавьте изменения в текущем каталоге в индекс для коммита (stage):
```
git add .
```
Сохраните изменения в коммите:
```
git commit -m "Second commit"
```
Отправьте изменения в центральный репозиторий:
```
git push
```
Откройте в консоли GCP сервис Cloud Build и следите за процессом сборки и публикации новой версии
Вернитесь сервис Cloud Run, откройте свой сервис и проверьте что трафик теперь обслуживается новой версией кода.
Проверьте что сообщение в браузере по URL сервиса изменилось.

app.js:

const express = require("express");


const app = express();
app.set('view engine', 'pug')


app.get("/", async (_req, res) => {
   res.render('index', {message: "Hello World!"})
});


const port = parseInt(process.env.PORT) || 8080;
app.listen(port, async () => {
   console.log(`Listening on port ${port}`);
});

package.json:

{
 "name": "demo",
 "version": "1.0.0",
 "main": "app.js",
 "scripts": {
   "start": "node app.js"
 },
 "license": "ISC",
 "dependencies": {
   "express": "^5.1",
   "pug": "^3.0"
 }
}

views/index.pug:

html
  body
    h1= message

Dockerfile

FROM node:lts
COPY . .
RUN npm ci
EXPOSE 8080
CMD npm run start