Firebase CLI и MCP-сервер ![Версия NPM][npm-badge]

Интерфейс командной строки Firebase (CLI) можно использовать для тестирования, управления и развёртывания вашего проекта Firebase из командной строки. Этот репозиторий также является домом для официального Firebase MCP-сервера. Для получения дополнительной информации ознакомьтесь с документацией Firebase MCP-сервера.

• Развёртывание кода и ресурсов в ваших проектах Firebase
• Запуск локального веб-сервера для вашего сайта Firebase Hosting
• Взаимодействие с данными в вашей базе данных Firebase
• Импорт/экспорт пользователей в Firebase Auth и из него

Чтобы начать работу с Firebase CLI, ознакомьтесь с полным списком команд ниже или изучите документацию.

Установка

Node-пакет

Вы можете установить Firebase CLI с помощью npm (менеджера пакетов Node). Обратите внимание, что вам потребуется установить Node.js и npm. Установка Node.js должна также установить npm.

Чтобы загрузить и установить Firebase CLI, выполните следующую команду:

npm install -g firebase-tools

Это предоставит вам глобально доступную команду firebase.

Автономный бинарный файл

Автономный бинарный дистрибутив Firebase CLI позволяет загрузить исполняемый файл firebase без каких-либо зависимостей.

Чтобы загрузить и установить CLI, выполните следующую команду:

curl -sL firebase.tools | bash

Команды

Команда firebase --help выводит список доступных команд, а firebase <command> --help показывает более подробную информацию по отдельной команде.

Если команда специфична для проекта, вы должны либо находиться внутри каталога проекта с активным псевдонимом проекта, либо указать идентификатор проекта Firebase с помощью флага -P <project_id>.

Ниже приведён краткий список доступных команд и их функций:

Команды конфигурации

Добавьте флаг --no-localhost к команде входа (например, firebase login --no-localhost), чтобы копировать и вставлять код вместо запуска локального сервера для аутентификации. Это может быть полезно, если вы подключаетесь по SSH к какому-либо серверу и вам нужно аутентифицироваться в Firebase на этой машине.

Команды управления проектами

Развёртывание и локальная эмуляция

Эти команды позволяют развёртывать и взаимодействовать с вашими сервисами Firebase.

Команды распространения приложений

Команды аутентификации

Подробная документация доступна здесь.

Команды Realtime Database

Команды расширений

Команды Cloud Firestore

Команды Cloud Functions

Команды Hosting

Команды Remote Config

Используйте firebase:deploy --only remoteconfig для обновления и публикации шаблона Firebase Remote Config проекта.

Аутентификация

Общие сведения

Firebase CLI может использовать один из четырёх методов аутентификации, перечисленных в порядке убывания приоритета:

• Токен пользователя - УСТАРЕЛО: этот метод аутентификации будет удалён в будущей основной версии firebase-tools; вместо него используйте учётную запись службы - предоставьте явный долгосрочный токен пользователя Firebase, сгенерированный с помощью firebase login:ci. Обратите внимание, что эти токены являются крайне чувствительными долгосрочными учётными данными и не являются подходящим вариантом для большинства случаев. Рассмотрите возможность использования авторизации через учётную запись службы. Токен можно задать одним из двух способов:
  • Укажите флаг --token для любой команды, например firebase --token="<token>" projects:list.
  • Задайте переменную окружения FIREBASE_TOKEN.
• Локальный вход - выполните команду firebase login, чтобы войти в CLI непосредственно от своего имени. CLI сохранит авторизованные учётные данные пользователя на вашем устройстве.

• Учётная запись службы — задайте переменную окружения GOOGLE_APPLICATION_CREDENTIALS, указав путь к файлу ключа учётной записи службы в формате JSON. Подробнее см. в руководстве Google Cloud Начало работы с аутентификацией.
• Учётные данные по умолчанию для приложений — если вы используете CLI gcloud и выполнили вход с помощью gcloud auth application-default login, Firebase CLI будет использовать их при отсутствии других учётных данных.

Несколько учётных записей

По умолчанию firebase login настраивает одну глобальную учётную запись для всех проектов. Если у вас несколько учётных записей Google, которые вы используете для проектов Firebase, вы можете авторизовать несколько учётных записей и применять их для каждого проекта или команды отдельно.

Чтобы авторизовать дополнительную учётную запись для использования с CLI, выполните firebase login:add. Просмотреть список авторизованных учётных записей можно с помощью firebase login:list.

Чтобы задать учётную запись по умолчанию для конкретного каталога проекта Firebase, выполните firebase login:use внутри этого каталога и выберите нужную учётную запись. Чтобы проверить учётную запись по умолчанию для каталога, выполните firebase login:list — учётная запись по умолчанию для текущего контекста будет указана первой.

Чтобы задать учётную запись для конкретного вызова команды, используйте флаг --account с любой командой. Например: firebase --account=user@domain.com deploy. Указанная учётная запись должна быть предварительно добавлена в Firebase CLI с помощью firebase login:add.

Эмулятор Cloud Functions

Эмулятор Cloud Functions доступен через команды, такие как emulators:start, serve и functions:shell. Эмулируемые Cloud Functions запускаются как независимые процессы node на вашем компьютере для разработки, что означает наличие собственного механизма обнаружения учётных данных.

По умолчанию эти процессы node не могут обнаруживать учётные данные, полученные через firebase login. Для улучшения опыта разработки, когда вы выполнили вход в CLI через firebase login, мы берём учётные данные пользователя и создаём временные учётные данные, которые передаём в эмулятор через GOOGLE_APPLICATION_CREDENTIALS. Это делается только в том случае, если вы не задали переменную окружения GOOGLE_APPLICATION_CREDENTIALS самостоятельно.

Использование за прокси-сервером

CLI поддерживает HTTP(S)-прокси через переменные окружения. Чтобы использовать прокси, задайте значение HTTPS_PROXY или HTTP_PROXY в вашем окружении, указав URL прокси (например, HTTP_PROXY=http://127.0.0.1:12345).

Использование в системах CI

Для аутентификации Firebase CLI требуется браузер, но полностью совместим с CI и другими средами без графического интерфейса.

Выполните следующие шаги, чтобы запускать команды Firebase в среде CI. Подробные инструкции для каждого шага см. в руководстве Google Cloud Начало работы с аутентификацией.

1. Создайте учётную запись службы и предоставьте ей соответствующий уровень доступа к вашему проекту.
2. Создайте ключ учётной записи службы (файл JSON) для этой учётной записи.
3. Сохраните файл ключа в безопасном и доступном месте в вашей системе CI.
4. Задайте GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json в вашей системе CI при выполнении команд Firebase.

Чтобы отключить доступ для учётной записи службы, найдите учётную запись службы для вашего проекта в Google Cloud Console, а затем удалите ключ или отключите либо удалите учётную запись.

Использование в качестве модуля

Firebase CLI также можно использовать программно как стандартный модуль Node. Каждая команда представлена в виде функции, которая принимает позиционные аргументы, за которыми следует объект параметров, и возвращает Promise.

Если мы выполним эту команду в командной строке:

$ firebase --project="foo" apps:list ANDROID

То в Node это будет выглядеть так:

const client = require("firebase-tools");
client.apps
  .list("ANDROID", { project: "foo" })
  .then((data) => {
    // ...
  })
  .catch((err) => {
    // ...
  });

Объект параметров должен быть последним аргументом, а любые неуказанные позиционные аргументы получат значение по умолчанию "". Следующие два вызова эквивалентны:

const client = require("firebase-tools");

// #1 - No arguments or options, defaults will be inferred
client.apps.list();

// #2 - Explicitly provide "" for all arguments and {} for options
client.apps.list("", {});

Примечание: при использовании в ограниченной среде, такой как Cloud Functions, не все команды firebase-tools будут работать программно, так как для этого требуется доступ к локальной файловой системе.

![npm-версия][npm-badge]

Firebase CLI (MCP)

Инструмент командной строки для Firebase.

Установка

Вариант 1 (рекомендуется): Установка через npm

```bash
curl -sL firebase.tools | bash

### Вариант 2: Установка с помощью Yarn

```bash
```bash
$ firebase --project="foo" apps:list ANDROID

### Вариант 3: Установка автономного бинарного файла

Загрузите автономный бинарный файл для своей платформы с [страницы релизов](https://github.com/firebase/firebase-tools/releases).

### Вариант 4: Использование Docker

```bash
```js
const client = require("firebase-tools");
client.apps
  .list("ANDROID", { project: "foo" })
  .then((data) => {
    // ...
  })
  .catch((err) => {
    // ...
  });

## Использование

```bash
```js
const client = require("firebase-tools");

// #1 - No arguments or options, defaults will be inferred
client.apps.list();

// #2 - Explicitly provide "" for all arguments and {} for options
client.apps.list("", {});

Запустите `firebase --help`, чтобы получить список всех доступных команд.

### Вход в систему

```bash

Инициализация проекта

Развёртывание

Документация

Полную документацию по Firebase CLI можно найти на официальном сайте Firebase.

Лицензия

MIT

Дополнительные команды

Локальный запуск функций

Запуск эмуляторов

Просмотр логов

Поддержка

Если у вас возникли проблемы или вопросы, обратитесь за помощью на Stack Overflow с тегом firebase или откройте issue в репозитории GitHub.

Участие в разработке

Мы приветствуем ваши pull request! Пожалуйста, ознакомьтесь с руководством по участию, прежде чем вносить изменения.

Примечание: Для использования Firebase CLI требуется Node.js версии 14 или выше.

多语言支持 (Поддержка нескольких языков)

• English
• 简体中文
• 日本語
• 한국어