Создание и загрузка функций в FunctionGraph

На этом этапе будут созданы бессерверные функции, которые выступят в роли API для веб-сайта.

Вы можете воспользоваться готовыми функциями или создать каждую из них самостоятельно:

• функция создания записи;

• функция получения записи;

• функция удаления записи.

Импорт готовых функций

Готовые функции достаточно загрузить в FunctionGraph, а затем настроить.

Скачайте готовые функции на свой компьютер:

• AddPet

• GetPets

• DelPet

Затем загрузите и настройте каждую функцию в FunctionGraph.

Загрузка функции в FunctionGraph

1. В списке сервисов выберите FunctionGraph.

2. Нажмите Create Function в правом верхнем углу.

3. В поле Function name укажите название функции — «AddPet», «GetPets» или «DelPet».

4. В списке Runtime выберите Node.js 12.13.

5. В поле Handler укажите название файла и название функции. Если используете код из примера, оставьте значение по умолчанию.

6. В поле Code Entry Mode выберите Upload ZIP и загрузите архив с функцией.

7. Нажмите Create Function.

Функция загружена в FunctionGraph.

Настройка функции в FunctionGraph

Для работы функции нужно указать переменные окружения. Для этого:

1. В разделе Functions сервиса FunctionGraph нажмите на название загруженной ранее функции.

2. Перейдите во вкладку Configuration.

3. В разделе Encryption Settings нажмите Add Now и введите данные для подключения к базе данных:

   • Key — DB_PASSWORD;

   • Value — пароль пользователя базы данных.

4. В разделе Environment Variables нажмите Add Now. Всего нужно добавить три параметра.

   Адрес экземпляра базы данных:

   • Key — DB_HOST;

   • Value — приватный IP-адрес сервера баз данных.

   Имя пользователя базы данных:

   • Key — DB_USER;

   • Value — имя пользователя.

   Название базы данных:

   • Key — DB_NAME;

   • Value — название базы данных.

5. Нажмите Save напротив каждого параметра.

6. В правом верхнем углу нажмите Save.

Когда все функции загружены и настроены, перейдите к настройке доступа к базе данных.

Функция создания записи

Эта функция реализовывает метод POST. Она принимает на вход JSON-файл с параметрами (имя, цвет и возраст питомца) и отправляет запрос к базе данных на создание записи.

Создание функции

1. Создайте каталог для хранения кода функции:

   mkdir catalog-name
   

2. Перейдите в созданный каталог:

   cd catalog-name
   

3. Инициализируйте проект:

   npm init -y
   

4. Установите зависимости:

   npm install mysql2
   

5. Создайте файл index.js:

   touch index.js
   

6. Добавьте в файл index.js код:

   exports.handler = async (event, context) => {
      const mysql = require("mysql2/promise");
      const db_connection = await mysql.createConnection({
            host: process.env.DB_HOST,
            user: process.env.DB_USER,
            database: process.env.DB_NAME,
            password: context.getUserData("DB_PASSWORD")
      });
   
      let buff = new Buffer(event.body, 'base64');
      let data = JSON.parse(buff.toString('utf8'));
   
      var insert_sql = "INSERT INTO pets (Name, Color, Age) VALUES (?, ?, ?)";
      var get_inserted_sql = "select * FROM pets where id =?"
   
      const [insertMetadata] = await db_connection.query(insert_sql, [data.name, data.color, data.age]);
      const [rows, fields] = await db_connection.query(get_inserted_sql, insertMetadata.insertId);
   
   
      const output =
      {
            'statusCode': 200,
            'headers':
            {
            'Content-Type': 'application/json'
            },
            'isBase64Encoded': false,
            'body': JSON.stringify(rows[0]),
      }
   
      db_connection.end();
      return output;
   }
   

7. Создайте ZIP-архив с содержимым каталога catalog-name. Архив должен включать в себя: index.js, package.json, package-lock.json и каталог node_modules.

Функция создания записи о питомцах готова. Архив нужно загрузить в FunctionGraph.

Загрузка функции в FunctionGraph

1. В списке сервисов выберите FunctionGraph.

2. Нажмите Create Function в правом верхнем углу.

3. В поле Function name укажите название функции — «AddPet», «GetPets» или «DelPet».

4. В списке Runtime выберите Node.js 12.13.

5. В поле Handler укажите название файла и название функции. Если используете код из примера, оставьте значение по умолчанию.

6. В поле Code Entry Mode выберите Upload ZIP и загрузите архив с функцией.

7. Нажмите Create Function.

Функция загружена в FunctionGraph.

Настройка функции в FunctionGraph

Для работы функции нужно указать переменные окружения. Для этого:

1. В разделе Functions сервиса FunctionGraph нажмите на название загруженной ранее функции.

2. Перейдите во вкладку Configuration.

3. В разделе Encryption Settings нажмите Add Now и введите данные для подключения к базе данных:

   • Key — DB_PASSWORD;

   • Value — пароль пользователя базы данных.

4. В разделе Environment Variables нажмите Add Now. Всего нужно добавить три параметра.

   Адрес экземпляра базы данных:

   • Key — DB_HOST;

   • Value — приватный IP-адрес сервера баз данных.

   Имя пользователя базы данных:

   • Key — DB_USER;

   • Value — имя пользователя.

   Название базы данных:

   • Key — DB_NAME;

   • Value — название базы данных.

5. Нажмите Save напротив каждого параметра.

6. В правом верхнем углу нажмите Save.

Функция добавления записей создана.

Функция получения записей

Эта функция реализовывает метод GET. Она не принимает никакие параметры на вход, а возвращает все записи из базы данных.

Создание функции

1. Создайте каталог для хранения кода функции:

   mkdir catalog-name
   

2. Перейдите в созданный каталог:

   cd catalog-name
   

3. Инициализируйте проект:

   npm init -y
   

4. Установите зависимости:

   npm install mysql2
   

5. Создайте файл index.js:

   touch index.js
   

6. Добавьте в файл index.js код:

   exports.handler = async (event, context) => {
      const mysql = require("mysql2/promise");
      const db_connection = await mysql.createConnection({
            host: process.env.DB_HOST,
            user: process.env.DB_USER,
            database: process.env.DB_NAME,
            password: context.getUserData("DB_PASSWORD")
      });
      var sql = "select * FROM pets";
      const [rows, fields] = await db_connection.query(sql);
   
      const output =
      {
            'statusCode': 200,
            'headers':
            {
               'Content-Type': 'application/json'
            },
            'isBase64Encoded': false,
            'body': JSON.stringify(rows)
      }
      db_connection.end();
      return output;
   }
   

7. Создайте ZIP-архив с содержимым каталога catalog-name. Архив должен включать в себя: index.js, package.json, package-lock.json и каталог node_modules.

Функция получения записей о питомцах готова. Архив нужно загрузить в FunctionGraph.

Загрузка функции в FunctionGraph

1. В списке сервисов выберите FunctionGraph.

2. Нажмите Create Function в правом верхнем углу.

3. В поле Function name укажите название функции — «AddPet», «GetPets» или «DelPet».

4. В списке Runtime выберите Node.js 12.13.

5. В поле Handler укажите название файла и название функции. Если используете код из примера, оставьте значение по умолчанию.

6. В поле Code Entry Mode выберите Upload ZIP и загрузите архив с функцией.

7. Нажмите Create Function.

Функция загружена в FunctionGraph.

Настройка функции в FunctionGraph

Для работы функции нужно указать переменные окружения. Для этого:

1. В разделе Functions сервиса FunctionGraph нажмите на название загруженной ранее функции.

2. Перейдите во вкладку Configuration.

3. В разделе Encryption Settings нажмите Add Now и введите данные для подключения к базе данных:

   • Key — DB_PASSWORD;

   • Value — пароль пользователя базы данных.

4. В разделе Environment Variables нажмите Add Now. Всего нужно добавить три параметра.

   Адрес экземпляра базы данных:

   • Key — DB_HOST;

   • Value — приватный IP-адрес сервера баз данных.

   Имя пользователя базы данных:

   • Key — DB_USER;

   • Value — имя пользователя.

   Название базы данных:

   • Key — DB_NAME;

   • Value — название базы данных.

5. Нажмите Save напротив каждого параметра.

6. В правом верхнем углу нажмите Save.

Функция получения записей создана.

Функция удаления записи

Эта функция реализовывает метод DELETE. Она принимает на вход идентификатор записи в базе данных и удаляет ее.

Создание функции

1. Создайте каталог для хранения кода функции:

   mkdir catalog-name
   

2. Перейдите в созданный каталог:

   cd catalog-name
   

3. Инициализируйте проект:

   npm init -y
   

4. Установите зависимости:

   npm install mysql2
   

5. Создайте файл index.js:

   touch index.js
   

6. Добавьте в файл index.js код:

   exports.handler = async (event, context) => {
      const mysql = require("mysql2/promise");
      const db_connection = await mysql.createConnection({
            host: process.env.DB_HOST,
            user: process.env.DB_USER,
            database: process.env.DB_NAME,
            password: context.getUserData("DB_PASSWORD")
      });
   
      const id = event.pathParameters.id;
      const delete_sql = "DELETE FROM pets WHERE id = ?";
      const [deleteMetadata] = await db_connection.query(delete_sql, [id]);
      db_connection.end();
   
      const output =
      {
            'statusCode': 204
      }
      return output;
   }
   

7. Создайте ZIP-архив с содержимым каталога catalog-name. Архив должен включать в себя: index.js, package.json, package-lock.json и каталог node_modules.

Функция удаления записи о питомцах готова. Архив нужно загрузить в FunctionGraph.

Загрузка функции в FunctionGraph

1. В списке сервисов выберите FunctionGraph.

2. Нажмите Create Function в правом верхнем углу.

3. В поле Function name укажите название функции — «AddPet», «GetPets» или «DelPet».

4. В списке Runtime выберите Node.js 12.13.

5. В поле Handler укажите название файла и название функции. Если используете код из примера, оставьте значение по умолчанию.

6. В поле Code Entry Mode выберите Upload ZIP и загрузите архив с функцией.

7. Нажмите Create Function.

Функция загружена в FunctionGraph.

Настройка функции в FunctionGraph

Для работы функции нужно указать переменные окружения. Для этого:

1. В разделе Functions сервиса FunctionGraph нажмите на название загруженной ранее функции.

2. Перейдите во вкладку Configuration.

3. В разделе Encryption Settings нажмите Add Now и введите данные для подключения к базе данных:

   • Key — DB_PASSWORD;

   • Value — пароль пользователя базы данных.

4. В разделе Environment Variables нажмите Add Now. Всего нужно добавить три параметра.

   Адрес экземпляра базы данных:

   • Key — DB_HOST;

   • Value — приватный IP-адрес сервера баз данных.

   Имя пользователя базы данных:

   • Key — DB_USER;

   • Value — имя пользователя.

   Название базы данных:

   • Key — DB_NAME;

   • Value — название базы данных.

5. Нажмите Save напротив каждого параметра.

6. В правом верхнем углу нажмите Save.

Функция удаления записей создана.

Настройка доступа к БД без внешнего IP-адреса

В рамках практической работы для доступа к базе данных данных не будет использоваться публичный IP-адрес. Чтобы получить доступ к базе данных по приватному IP, функции в FunctionGraph можно интегрировать с виртуальными сетями. Для этого:

1. В разделе Functions сервиса FunctionGraph нажмите на название функции.

2. Перейдите во вкладку Configuration.

3. В поле Agency нажмите Create Agency.

4. На странице Agencies нажмите Create Agency.

5. В поле Agency Name укажите название создаваемого агентства.

6. В поле Agency Type выберите Cloud service.

7. В списке Cloud Service выберите FunctionGraph.

8. В списке Validity Period выберите Unlimited.

9. Нажмите Assign Permission.

10. С помощью поиска найдите и выберите роль VPC Administrator.

11. Нажмите OK.

12. Откройте страницу функции и в Confuguration → Agency обновите список агентств.

13. В списке выберите созданное агентство.

14. Активируйте параметр VPC Access.

15. Выберите VPC и подсеть, доступ к которым будет иметь функция. Используйте ту подсеть виртуальной сети, в которой находится ранее созданная база данных.

16. Нажмите Save.

Функция готова к работе с сервером баз данных, у которого нет доступа в интернет. Для двух других функций также назначьте созданное агентство и добавьте их в ту же подсеть.

Следующий шаг — публикация функций через API Gateway.

Была ли статья полезной?

Да Нет

НазадСоздание базы данных

ДалееПубликация функций через API Gateway