Руководство по развертыванию приложения PHP, MySQL и Redis в службе приложение Azure

2. Создание службы приложений, базы данных и кэша

В этом шаге вы создадите ресурсы Azure. Действия, используемые в этом руководстве, создают набор защищенных по умолчанию ресурсов, включающих службу приложений, базу данных Azure для MySQL и кэш Azure для Redis. Для процесса создания укажите:

• The Name for the web app. Он используется в качестве части DNS-имени приложения в виде https://<app-name>-<hash>.<region>.azurewebsites.net.
• The Region to run the app physically in the world. Он также используется в качестве части DNS-имени приложения.
• The Runtime stack for the app. Здесь следует выбрать версию PHP, которая будет использоваться для приложения.
• План размещения для приложения. Это ценовая категория, которая включает набор функций и емкость масштабирования для вашего приложения.
• Группа ресурсов для приложения. Группа ресурсов позволяет группировать (в логическом контейнере) все ресурсы Azure, необходимые для приложения.

Войдите на портал Azure и выполните следующие действия, чтобы создать ресурсы Службы приложений Azure.

3. Секреты безопасного подключения

Мастер создания создал переменные подключения для вас уже в качестве параметров приложения. However, the security best practice is to keep secrets out of App Service completely. You'll move your secrets to a key vault and change your app setting to Key Vault references with the help of Service Connectors.

To summarize, the process for securing your connection secrets involved:

• Retrieving the connection secrets from the App Service app's environment variables.
• Creating a key vault.
• Creating a Key Vault connection with the system-assigned managed identity.
• Updating the service connectors to store the secrets in the key vault.

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

4. Настройка переменных Laravel

5. Развертывание примера кода

На этом шаге вы настроите развертывание GitHub с помощью GitHub Actions. Это всего лишь один из множества способов развертывания в Службе приложений, но это также отличный способ обеспечения непрерывной интеграции в процессе развертывания. По умолчанию каждый git push из репозитория GitHub запускает действие сборки и развертывания.

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

6. Создание схемы базы данных

Мастер создания помещает сервер базы данных MySQL за частной конечной точкой, поэтому он доступен только из виртуальной сети. Так как приложение Службы приложений уже интегрировано с виртуальной сетью, выполнять миграции баз данных с вашей базой данных проще всего непосредственно из контейнера Службы приложений.

7 - Change site root

Жизненный цикл приложения Laravel начинается в каталоге /public. Контейнер PHP по умолчанию для App Service использует Nginx, который работает в корневом каталоге приложения. Чтобы изменить корневой каталог сайта, необходимо изменить файл конфигурации Nginx в контейнере PHP (/etc/nginx/sites-available/default). Для удобства пример репозитория содержит пользовательский файл конфигурации, который называется default. Как отмечалось ранее, вы не хотите заменить этот файл с помощью оболочки SSH, так как изменение выходит за /home пределы и будет потеряно после перезапуска приложения.

8. Переход к приложению

9 - Stream diagnostic logs

Служба приложений Azure захватывает все сообщения, выводимые на консоль, чтобы помочь вам в диагностике проблем с приложением. Пример приложения выводит сообщения журнала консоли в каждой из своих конечных точек для демонстрации этой возможности. By default, Laravel's logging functionality (for example, Log::info()) outputs to a local file. Ваш предыдущий параметр LOG_CHANNEL приложения делает записи журнала доступными из потока журналов службы приложений.

Очистка ресурсов

По завершении работы можно удалить все ресурсы из вашей подписки Azure, удалив соответствующую группу ресурсов.

2. Создание ресурсов Azure и развертывание примера приложения

На этом шаге вы создадите ресурсы Azure и развернете образец приложения в Службе приложений на Linux. Действия, используемые в этом руководстве, создают набор безопасных ресурсов по умолчанию, включающих Служба приложений и База данных Azure для MySQL.

Пространство кода GitHub уже имеет интерфейс командной строки разработчика Azure (AZD).

1. Создайте ключ шифрования Laravel с помощью php artisan key:generate --show:

   php artisan key:generate --show
   

2. Войдите в Azure, выполнив команду azd auth login и следуя подсказкам.

   azd auth login
   

3. Создайте необходимые ресурсы Azure и разверните код приложения с помощью команды azd up. Следуйте запросу, чтобы выбрать нужную подписку и расположение для ресурсов Azure.

   azd up
   

4. При появлении запроса укажите следующие ответы:

   Вопрос	Ответ
   Введите новое имя среды	Введите уникальное имя. Шаблон AZD использует это имя как часть DNS-имени веб-приложения в Azure (<app-name>-<hash>.azurewebsites.net). Разрешены буквенно-цифровые символы и дефисы.
   Выбор подписки Azure для использования	Выберите подписку.
   Выбор расположения Azure для использования	Выберите расположение.
   Введите значение для защищенного параметра инфраструктуры appKey	Use the output of php artisan key:generate --show here. Шаблон AZD создает секрет для Key Vault, который можно использовать в вашем приложении.
   Введите значение для защищенного параметра инфраструктуры databasePassword	Пароль базы данных для MySQL. Оно должно содержать по крайней мере 8 символов и содержать прописные буквы, строчные буквы, цифры и специальные символы.

   Выполнение azd up команды занимает около 15 минут (кэш Redis занимает больше всего времени). Он также компилирует и развертывает код вашего приложения, но позже вы измените его, чтобы он работал с App Service. Во время выполнения команда предоставляет сообщения о процессе подготовки и развертывания, включая ссылку на развертывание в Azure. По завершении команда также отображает ссылку на приложение развертывания.

   Этот шаблон AZD содержит файлы (azure.yaml и каталог infra), создающие архитектуру безопасную по умолчанию со следующими ресурсами Azure:

   • Группа ресурсов: контейнер для всех созданных ресурсов.
   • План службы приложений: Определяет вычислительные ресурсы для службы приложений. A Linux plan in the B1 tier is created.
   • App Service: Represents your app and runs in the App Service plan.
   • Виртуальная сеть: интегрированная с приложением Служба приложений и изолирует внутренний сетевой трафик.
   • Azure Database for MySQL Flexible Server: доступен только из виртуальной сети через интеграцию зоны DNS. База данных создается для вас на сервере.
   • Кэш Azure для Redis. Доступно только из виртуальной сети.
   • Private endpoints: Access endpoints for the key vault and the Redis cache in the virtual network.
   • Частные зоны DNS: включите возможность разрешения DNS для хранилища ключей, сервера базы данных и кэша Redis в виртуальной сети.
   • Рабочая область Log Analytics: служит целевым контейнером для вашего приложения для отправки журналов, в которой вы также можете запрашивать журналы.
   • Хранилище ключей. Используется для сохранения пароля базы данных при повторном развертывании с помощью AZD.

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

3. Использование строк подключения Azure в коде приложения

Шаблон AZD, который вы используете, создал переменные подключения для вас уже в виде параметров приложения и выводит их в терминал для вашего удобства. Параметры приложения — это один из способов уберечь секреты подключения от попадания в репозиторий кода.

1. В выходных данных AZD найдите параметры приложения, начинающиеся с AZURE_MYSQL_ и AZURE_REDIS_. Отображаются только имена параметров. Они выглядят следующим образом в выходных данных AZD:

    App Service app has the following app settings:
            - AZURE_KEYVAULT_RESOURCEENDPOINT
            - AZURE_KEYVAULT_SCOPE
            - AZURE_MYSQL_DBNAME
            - AZURE_MYSQL_FLAG
            - AZURE_MYSQL_HOST
            - AZURE_MYSQL_PASSWORD
            - AZURE_MYSQL_PORT
            - AZURE_MYSQL_USERNAME
            - AZURE_REDIS_DATABASE
            - AZURE_REDIS_HOST
            - AZURE_REDIS_PASSWORD
            - AZURE_REDIS_PORT
            - AZURE_REDIS_SSL
    

   Параметры, начинающиеся с AZURE_MYSQL_, являются переменными подключения для базы данных MySQL, а параметры, начинающиеся с AZURE_REDIS_, предназначены для кэша Redis. Позже их необходимо использовать в коде. Для удобства шаблон AZD отображает прямую ссылку на страницу параметров приложения на портале Azure.

2. В обозревателе откройте config/database.php. Это файл конфигурации для подключений к кэшу базы данных и Redis.

3. Найдите часть, которая определяет mysql соединение (строки 46-64) и замените DB_HOST, DB_PORT, DB_DATABASEDB_USERNAMEи DB_PASSWORD параметрами AZURE_MYSQL_ приложения из выходных данных AZD. Подключение mysql должно выглядеть следующим образом.

   'mysql' => [
       'driver' => 'mysql',
       'url' => env('DATABASE_URL'),
       'host' => env('AZURE_MYSQL_HOST', '127.0.0.1'),
       'port' => env('AZURE_MYSQL_PORT', '3306'),
       'database' => env('AZURE_MYSQL_DBNAME', 'forge'),
       'username' => env('AZURE_MYSQL_USERNAME', 'forge'),
       'password' => env('AZURE_MYSQL_PASSWORD', ''),
       'unix_socket' => env('DB_SOCKET', ''),
       'charset' => 'utf8mb4',
       'collation' => 'utf8mb4_unicode_ci',
       'prefix' => '',
       'prefix_indexes' => true,
       'strict' => true,
       'engine' => null,
       'options' => extension_loaded('pdo_mysql') ? array_filter([
           PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
       ]) : [],
   ],
   

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

4. Найдите часть, определяющую подключение кэша Redis (строки 140-147), и замените REDIS_HOST, REDIS_PASSWORD, REDIS_PORT и REDIS_CACHE_DB на параметры Azure_REDIS_ приложения из выходных данных AZD. Кроме того, добавьте 'scheme' => 'tls', в подключение. Подключение к кэшу должно выглядеть следующим образом:

   'cache' => [
       'scheme' => 'tls',
       'url' => env('REDIS_URL'),
       'host' => env('AZURE_REDIS_HOST', '127.0.0.1'),
       'username' => env('REDIS_USERNAME'),
       'password' => env('AZURE_REDIS_PASSWORD'),
       'port' => env('AZURE_REDIS_PORT', '6379'),
       'database' => env('AZURE_REDIS_DATABASE', '1'),
   ],
   

   Дополнительные сведения о конфигурации кэша Redis в Laravel см. в документации по Laravel.

   Примечание.

   Remember that your changes aren't deployed yet. Вы развернете их в конце следующего шага.

4. Настройка параметров Laravel в веб-приложении

1. В обозревателе откройте infra/resources.bicep. Это файл шаблона Bicep, определяющий созданные ресурсы Azure.

2. Найдите часть, которая определяет параметры приложения (строки 510-514) и раскомментируйте их. Эти параметры приложения:

   Настройки	Описание
   CACHE_DRIVER	Инструктирует Laravel использовать Redis в качестве системы кэширования (см. документацию по Laravel).
   MYSQL_ATTR_SSL_CA	Необходимо открыть подключение TLS к MySQL в Azure. Файл сертификата включен в пример репозитория для удобства. This variable is used by the mysql connection in config/database.php
   LOG_CHANNEL	Указывает Laravel направлять журналы в stderr, что делает их доступными для журналов службы приложений (см. документацию Laravel).
   APP_DEBUG	Включите страницы режима отладки в Laravel (см. документацию по Laravel).
   APP_KEY	Переменная шифрования Laravel. Шаблон AZD уже создал секрет Key Vault (строки 212-217), поэтому вы получаете к нему доступ с помощью ссылки на Key Vault.

3. In infra/resources.bicep, find the resource definition for the App Service app and uncomment line 315:

   appCommandLine: 'cp /home/site/wwwroot/default /etc/nginx/sites-available/default && service nginx reload'
   

   Жизненный цикл приложения Laravel начинается в каталоге /public directory вместо корневого каталога приложения. Контейнер PHP по умолчанию для службы приложений использует Nginx, который начинается в корневом каталоге приложения. Чтобы изменить корневой каталог сайта, необходимо изменить файл конфигурации Nginx в контейнере PHP (/etc/nginx/sites-available/default). For your convenience, the sample repository contains a replacement configuration file called default, which tells Nginx to look in the /public directory. Эта настраиваемая команда appCommandLine запускается каждый раз, когда приложение запускается, чтобы применять замену файлов при каждом перезапуске контейнера Linux из чистого состояния.

4. Вернитесь в терминал Codespace и запустите azd up еще раз.

   azd up
   

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

5. Создание схемы базы данных

С помощью базы данных MySQL, защищенной виртуальной сетью, проще всего запустить миграцию баз данных Laravel в сеансе SSH с контейнером Linux в службе приложений.

1. В выходных данных AZD найдите URL-адрес сеанса SSH и перейдите к нему в браузере. Это выглядит следующим образом в выходных данных:

    Open SSH session to App Service container at: https://<app-name>-<hash>.scm.azurewebsites.net/webssh/host
    

2. В сеансе SSH выполните миграцию базы данных из каталога /home/site/wwwroot :

   cd /home/site/wwwroot
   php artisan migrate --force
   

   При успешном завершении Служба приложений успешно подключается к базе данных.

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

6. Перейдите к приложению

1. В выходных данных AZD найдите URL-адрес приложения и перейдите к нему в браузере. URL-адрес выглядит следующим образом в выходных данных AZD:

    Deploying services (azd deploy)
   
      (✓) Done: Deploying service web
      - Endpoint: https://<app-name>-<hash>.azurewebsites.net/
    

2. Добавьте несколько задач в список.

   

   Поздравляем, вы запускаете веб-приложение в службе приложение Azure с безопасным подключением к База данных Azure для MySQL.

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

7. Трансляция журналов диагностики

Служба приложений Azure захватывает все сообщения, выводимые на консоль, чтобы помочь вам в диагностике проблем с приложением. For convenience, the AZD template already enabled logging to the local file system and is shipping the logs to a Log Analytics workspace.

Пример приложения выводит сообщения журнала консоли в каждой из своих конечных точек для демонстрации этой возможности. By default, Laravel's logging functionality (for example, Log::info()) outputs to a local file. Ваш предыдущий параметр LOG_CHANNEL приложения делает записи журнала доступными из потока журналов службы приложений.

Route::get('/', function () {
    Log::info("Get /");
    $startTime = microtime(true);
    // Simple cache-aside logic
    if (Cache::has('tasks')) {
        $data = Cache::get('tasks');
    } else {
        $data = Task::orderBy('created_at', 'asc')->get();
        Cache::add('tasks', $data);
    }
    return view('tasks', ['tasks' => $data, 'elapsed' => microtime(true) - $startTime]);
});

In the AZD output, find the link to stream App Service logs and navigate to it in the browser. Ссылка выглядит следующим образом в выходных данных AZD:

Stream App Service logs at: https://portal.azure.com/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream

Возникли проблемы? Ознакомьтесь с разделом "Устранение неполадок".

8. Очистка ресурсов

Чтобы удалить все ресурсы Azure в текущей среде развертывания, выполните azd down и следуйте инструкциям.

azd down

• Сколько стоит такая конфигурация?
• Как подключиться к базе данных MySQL, защищенной виртуальной сетью, с помощью других средств?
• Как изменить параметр приложения APP_KEY на ссылку Key Vault?
• Как осуществляется разработка локальных приложений с использованием GitHub Actions?
• Почему развертывание GitHub Actions идет так медленно?
• У меня нет разрешений на создание идентификатора, назначенного пользователем
• Что можно сделать с помощью GitHub Copilot в моем пространстве кода?

• Сколько стоит такая конфигурация?
• Как подключиться к базе данных MySQL, защищенной виртуальной сетью, с помощью других средств?
• Как осуществляется разработка локальных приложений с использованием GitHub Actions?
• Почему развертывание GitHub Actions идет так медленно?
• У меня нет разрешений на создание идентификатора, назначенного пользователем
• Что можно сделать с помощью GitHub Copilot в моем пространстве кода?

Как изменить настройку приложения APP_KEY на ссылку на Key Vault?

На шаге 4 на портале Настройка переменных Laravel можно изменить APP_KEY, чтобы он ссылался на Key Vault, выполнив следующие команды Azure CLI в Codespace GitHub:

# Change the following variables to match your environment
SUBSCRIPTION_ID=<subscription-id>
RESOURCE_GROUP=<resource-group-name>
KEY_VAULT_NAME=<key-vault-name>
APP_SERVICE_NAME=<app-name>
SECRET_NAME=laravelAppKey

# Set the subscription ID
az account set --subscription $SUBSCRIPTION_ID

# Assign 'Key Vault Secrets Officer' role to your user at the scope of the key vault
az role assignment create \
  --assignee $(az ad signed-in-user show --query id -o tsv) \
  --role $(az role definition list --name "Key Vault Secrets Officer" --query "[].id" -o tsv) \
  --scope $(az keyvault show --name $KEY_VAULT_NAME --resource-group $RESOURCE_GROUP --query id --output tsv)

# Add the secret to the key vault
az keyvault secret set \
  --vault-name $KEY_VAULT_NAME \
  --name $SECRET_NAME \
  --value $(php artisan key:generate --show)

# Add Key Vault reference to the App Service configuration
az webapp config appsettings set \
  --resource-group $RESOURCE_GROUP \
  --name $APP_SERVICE_NAME \
  --settings "[email protected](SecretUri=https://$KEY_VAULT_NAME.vault.azure.net/secrets/$SECRET_NAME)"

Вы также можете сделать то же самое на портале. Дополнительные сведения можно найти здесь

1. Key Vault scope role assignment
2. Добавление секрета в Key Vault
3. Получение секрета из Key Vault
4. Настройка параметров приложения