AWS RDS

Цель работы

Цель работы: познакомиться с сервисом Amazon RDS и понятием headless CMS.

Теоретическая часть

Варианты развертывания СУБД:

Установить СУБД на локальном сервере on-Premise
Установить СУБД в контейнер на локальном сервере on-Premise
Установить СУБД в сервере в облаке
Установить СУБД в контейнере на сервере в облаке
Использовать СУБД в контейнере в облачном сервисе
Использовать облачный сервис

Преимущества облачного сервиса:

простое масштабирование
простое резервное копирование
производительность при масштабировании серверов приложения
не нужно поддерживать ОС и ПО СУБД

Недостатки облачного сервиса:

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

Облачные СУБД:

Реляционные
- Amazon Aurora
- Amazon Redshift
- Amazon RDS, которая
  - Amazon Aurora (в режиме совместимости с MySQL или PostgreSQL)
  - MySQL
  - MariaDB
  - Oracle Database
  - Microsoft SQL Server
  - PostgreSQL
Нереляционные (NoSQL)
- документные (AWS DocumentDB (MongoDB))
- хранилища key-value (Amazon MemoryDB (Redis), Amazon DynamoDB)
- хранилища wide-column (Amazon Keyspaces (Cassandra))
- графовые (Amazon Neptune)
- для временных рядов (Amazon Timestream)

Практическая часть

Перед началом работы войдите в веб-консоль

Откройте сервис RDS (в регионе Hong Kong, Seoul или Tokyo), нажмите Create database
- Engine type: MySQL
- Template: Free tier
- DB instance identifier: <группа>-<фамилия>
- Master username: strapi_user
- Master password — придумайте новый пароль
Оставьте остальные параметры по умолчанию и нажмите Create database.
Откройте в том же регионе сервис EC2 и нажмите Launch instance
- Name: <группа>-<фамилия>
- Amazon Machine Image: Ubuntu Server 24.04 LTS
- Instance type t3.medium
- Key pair: Выберите свой ключ (или создайте новый)
- Firewall (security group): Select existing security group (default)
Оставьте остальные параметры по умолчанию и нажмите Launch instance.
Откройте на локальном компьютере терминал и подключитесь к серверу по SSH.
```
ssh -i <файл с ключом> ubuntu@<адрес сервера>
```
Установите на сервере пакет mysql-client
```
sudo apt update && sudo apt install -y mysql-client
```
Откройте созданную в сервисе RDS базу данных и сохраните endpoint для дальнейшего использования.
Подключитесь к СУБД MySQL
```
mysql -u strapi_user -p -h <RDS-endpoint>
```
с помощью команды SHOW DATABASES; перечислите имеющиеся базы данных.
Создайте базу данных для приложения:
```
CREATE DATABASE strapi_db;
```
с помощью команды SHOW DATABASES; проверьте что база данных была успешно создана.

с помощью команды exit закройте клиент MySQL.
Установите Node.js LTS (инструкция)
```
sudo apt-get install -y curl
curl -fsSL https://deb.nodesource.com/setup_22.x -o nodesource_setup.sh
sudo -E bash nodesource_setup.sh
sudo apt-get install -y nodejs
```
проверьте что Node.js установился: node -v

проверьте что NPM установился: npm -v
Создайте проект books на базе CMS Strapi:
```
npx create-strapi-app@latest --skip-cloud --no-example --no-git-init books
```
Вместо sqlite выберите mysql, введите параметры созданной ранее БД (endpoint сервера СУБД, имя базы данных созданной в клиенте MySQL, имя и пароль пользователя СУБД). Значения остальных параметров оставьте по умолчанию.

Войдите в каталог приложения и измените в конфигурационном файле порт на 8080. Перепроверьте параметры подключения к базе данных.
```
cd books
nano .env
```
скомпилируйте и запустите приложение
```
npm run build
npm run develop
```
Откройте админку в браузере CMS Strapi (вместо localhost используйте публичный IP-адрес EC2-инстанса), создайте нового администратора.
Перейдите в Content-Types Builder и создайте новую коллекцию Books с полями:
- author (Short text)
- title (Short text)
После сохранения изменений в структуре БД дождитесь перезапуска сервера.
Вернитесь на домашнюю страницу, перейдите в Content Manager, откройте созданную коллекцию Books и создайте несколько записей.
Перейдите в Settings, API Tokens, откройте токен с полными правами, заново сгенерируйте и скопируйте его.
Откройте клиент для REST API HTTPie, перейдите в приложение (Go to App), на вкладке Auth выберите вариант аутентификации Token Bearer и выполните запрос:
- GET http://:8080/api/books
Если HTTPie не удается открыть тогда откройте терминал на локальном компьютере и выполните запрос с помощью cURL:
```
curl -H "Authorization: Bearer <токен>" http://<IP-адрес сервера>:/api/books
```
Создайте новый запрос, измените метод с GET на POST, введите прежний адрес, введите параметры аутентификации, на вкладке Body выберите Text, JSON и введите данные по следующему образцу:
```
{
  "data": {
    "author": "Введите имя автора книги",
    "title": "Введите название книги"
  }
}
```
выполните запрос по предыдущему адресу, в ответе сервера должны присутствовать новые поля (id, documentId, createdAt, updatedAt, publishedAt) которые свидетельствуют о записи в БД.

Если в предыдущем пункте вы использовали cURL в терминале, тогда сохраните JSON с данными новой книги в файле и в терминале выполните следующую команду:
```
curl -X POST -H "Authorization: Bearer <токен>" -H "Content-Type: application/json" -d @<имя JSON-файла> http://<IP-адрес сервера>:/api/books
```
Проверьте, что введенные данные появились в менеджере контента в CMS Strapi.
Вернитесь в терминал с запущенным приложением и остановите его нажав Ctrl+C. Подключитесь к СУБД MySQL
```
mysql -u strapi_user -p -h <RDS-endpoint>
```
выполните запросы:
```
USE strapi_db;
SHOW TABLES;
SELECT * FROM books;
```
Проверьте что введенные в приложение данные сохранены в БД.