---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.3
alternate:
  - https://sourcecraft.dev/portal/docs/en/sourcecraft/quickstart.md
  - https://sourcecraft.dev/portal/docs/ru/sourcecraft/quickstart.md
  - href: ru/sourcecraft/quickstart.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
title: Начало работы с SourceCraft
description: 'Как начать работать с SourceCraft: регистрация, создание репозитория, настройка CI/CD и внесение изменений.'
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/ru/llms.txt


# Как начать работать с SourceCraft

<!-- source: ru/_includes/sourcecraft/intro.md -->
_SourceCraft_ — платформа, с помощью которой вы можете разрабатывать исходный код, управлять версиями, тестировать, собирать, развертывать и сопровождать программные продукты. Сервис представляет собой систему управления репозиториями кода для [git](https://git-scm.com/) с отслеживанием ошибок и пайплайном CI/CD.

Подробнее о работе с `git` на странице [Как начать работать с git](https://sourcecraft.dev/portal/docs/ru/sourcecraft/tutorials/quickstart-git.md).
<!-- endsource: ru/_includes/sourcecraft/intro.md -->

<!-- source: ru/_includes/sourcecraft/terms-link.md -->
[Условия использования сервиса SourceCraft](https://yandex.ru/legal/cloud_terms_sourcecraft/ru/)
<!-- endsource: ru/_includes/sourcecraft/terms-link.md -->

<iframe width="640" height="360" src="https://runtime.strm.yandex.ru/player/video/vplvx5ax7rgnwegswboa?autoplay=0&mute=0" allow="autoplay; fullscreen; picture-in-picture; encrypted-media" frameborder="0" scrolling="no"></iframe>

Чтобы начать работу с сервисом:
1. [Зарегистрируйтесь](#registration).
1. [Создайте репозиторий](#create-repo).
1. [Проверьте тестовый CI-процесс](#test-ci).
1. [Подготовьте окружение](#prepare-environment).
1. [Добавьте SSH-ключ в SourceCraft](#add-ssh).
1. [Клонируйте репозиторий](#clone-repo).
1. [Внесите изменения в новую ветку](#commit-push).
1. [Предложите изменения](#create-pr).
1. [Выполните слияние с основной веткой](#merge-pr).

## Зарегистрируйтесь {#registration}

<!-- source: ru/_includes/sourcecraft/registration.md -->
1. Если у вас еще нет [Яндекс ID](https://id.yandex.ru/), [зарегистрируйтесь](https://yandex.ru/support/id/ru/authorization/registration.html).

    Если для входа на Яндекс вы используете профиль в социальной сети, [заведите логин и пароль](https://passport.yandex.ru/passport?mode=postregistration&create_login=1).
1. На [главной странице SourceCraft](https://sourcecraft.dev) нажмите **Войти** и выберите профиль Яндекс ID, с которым вы хотите зарегистрироваться в сервисе.
1. Выберите [организацию](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/index.md#org), которая будет использоваться для работы с сервисом.

    <!-- source: ru/_includes/sourcecraft/org-yc.md -->
    Если у вас уже зарегистрирована [организация в Yandex Cloud](https://yandex.cloud/ru/docs/billing/concepts/organization), вы можете использовать ее в SourceCraft.

    Если у вас нет организации в Yandex Cloud, автоматически будет создана организация для работы с SourceCraft.
    <!-- endsource: ru/_includes/sourcecraft/org-yc.md -->

    Также вы можете создать новую организацию.

    {% note tip %}

    <!-- source: ru/_includes/sourcecraft/federations-note.md -->
    Для авторизации корпоративных аккаунтов в SourceCraft с помощью системы единого входа (Single Sign-On, SSO) вы можете использовать [SAML-совместимые федерации удостоверений](https://yandex.cloud/ru/docs/organization/concepts/add-federation) Yandex Cloud.
    <!-- endsource: ru/_includes/sourcecraft/federations-note.md -->

    {% endnote %}

1. Нажмите **Продолжить** ![image](../_assets/console-icons/arrow-right.svg).
1.  На открывшейся странице заполните информацию профиля:
    * **Имя** (обязательное поле);
    * **Страна**;
    * **Город**;
    * **Компания**;
    * **Должность**;
    * **О себе**;
    * **Ссылки**.

    Также вы можете добавить изображение для профиля и фон.

1. Нажмите **Выглядит отлично, открыть дашборд**.
<!-- endsource: ru/_includes/sourcecraft/registration.md -->

## Создайте репозиторий {#create-repo}

1. На панели слева нажмите ![image](../_assets/console-icons/plus.svg) **Создать репозиторий**.
1. В блоке **Сведения о новом репозитории**:
    * Выберите **Пустой репозиторий** — будет создан новый репозиторий.

      Также вы можете [импортировать](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/migration.md) существующий репозиторий в SourceCraft.

    * В поле **Название** укажите название репозитория, например `test-repo`. Название репозитория может содержать следующие [ASCII-символы](https://ru.wikipedia.org/wiki/ASCII): строчные и заглавные буквы латинского алфавита, цифры, запятые, дефисы и подчеркивания.
    * (опционально) В поле **Описание** укажите описание репозитория.
1. <!-- source: ru/_includes/sourcecraft/repo-create-template.md -->
   В блоке **Шаблон репозитория** нажмите **Просмотр шаблонов**, выберите подходящий шаблон репозитория и нажмите **Использовать шаблон**.

   Шаблоны содержат предустановленную [конфигурацию CI/CD](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ci-cd.md), а также типовые файлы проекта.

   Чтобы посмотреть содержимое шаблона, нажмите **Предварительный просмотр**.
   <!-- endsource: ru/_includes/sourcecraft/repo-create-template.md -->
1. В блоке **Видимость** выберите тип доступа к репозиторию — **Приватный**. Доступ к репозиторию будут иметь только пользователи, приглашенные вами.
1. Нажмите **Создать репозиторий**.

## Проверьте тестовый CI/CD-процесс {#test-ci}

При инициализации репозитория будет выполнен тестовый CI/CD-процесс.

Проверьте выполнение CI/CD-процесса:

<!-- source: ru/_includes/sourcecraft/ci-cd/ui-overview.md -->
1. На странице репозитория в разделе ![image](../_assets/console-icons/code.svg) **Код** перейдите в секцию ![image](../_assets/console-icons/arrows-3-rotate-right.svg) **CI/CD**.
1. Выберите запущенный рабочий процесс (workflow).
1. На открывшейся странице будут отображены все задания (tasks) рабочего процесса, шаги задания — кубики (cubes), а также статусы и результаты выполнения.
<!-- endsource: ru/_includes/sourcecraft/ci-cd/ui-overview.md -->

## Подготовьте окружение {#prepare-environment}

<!-- source: ru/_includes/sourcecraft/prepare-environment.md -->
1. Создайте пару из открытого и закрытого SSH-ключей для учетной записи в SourceCraft:

    {% list tabs group=operating_system %}

    - Linux/macOS {#linux-macos}

      <!-- source: ru/_includes/vm-ssh-prepare-key-linux-macos.md -->
      1. Откройте терминал.
      1. Создайте новый ключ с помощью команды `ssh-keygen`:

          ```bash
          ssh-keygen -t ed25519 -C "<опциональный_комментарий>"
          ```

          Вы можете передать в параметре `-C` пустую строку, чтобы не добавлять комментарий, или не указывать параметр `-C` вообще — в таком случае будет добавлен комментарий по умолчанию.

          После выполнения команды вам будет предложено указать имя и путь к файлам с ключами, а также ввести пароль для закрытого ключа. Если задать только имя, пара ключей будет создана в текущей директории. Открытый ключ будет сохранен в файле с расширением `.pub`, закрытый ключ — в файле без расширения.

          По умолчанию команда предлагает сохранить ключ под именем `id_ed25519` в директории `/home/<имя_пользователя>/.ssh`. Если в этой директории уже есть SSH-ключ с именем `id_ed25519`, вы можете случайно перезаписать его и потерять доступ к ресурсам, в которых он используется. Поэтому рекомендуется использовать уникальные имена для всех SSH-ключей.
      <!-- endsource: ru/_includes/vm-ssh-prepare-key-linux-macos.md -->

    - Windows 10/11 {#windows}

      <!-- source: ru/_includes/vm-ssh-prepare-key-win-10-11.md -->
      Если у вас еще не установлен [OpenSSH](https://ru.wikipedia.org/wiki/OpenSSH), установите его по [инструкции](https://learn.microsoft.com/ru-ru/windows-server/administration/openssh/openssh_install_firstuse).

      1. Запустите `cmd.exe` или `powershell.exe` (предварительно обновите PowerShell).
      1. Создайте новый ключ с помощью команды `ssh-keygen`:

          ```shell
          ssh-keygen -t ed25519 -C "<опциональный_комментарий>"
          ```

          Вы можете передать в параметре `-C` пустую строку, чтобы не добавлять комментарий, или не указывать параметр `-C` вообще — в таком случае будет добавлен комментарий по умолчанию.

          После выполнения команды вам будет предложено указать имя и путь к файлам с ключами, а также ввести пароль для закрытого ключа. Если задать только имя, пара ключей будет создана в текущей директории. Открытый ключ будет сохранен в файле с расширением `.pub`, закрытый ключ — в файле без расширения.

          По умолчанию команда предлагает сохранить ключ под именем `id_ed25519` в папку `C:\Users\<имя_пользователя>/.ssh`. Если в этой директории уже есть SSH-ключ с именем `id_ed25519`, вы можете случайно перезаписать его и потерять доступ к ресурсам, в которых он используется. Поэтому рекомендуется использовать уникальные имена для всех SSH-ключей.
      <!-- endsource: ru/_includes/vm-ssh-prepare-key-win-10-11.md -->

    - Windows 7/8 {#windows7-8}

      <!-- source: ru/_includes/vm-ssh-prepare-key-win-7-8.md -->
      Создайте ключи с помощью приложения PuTTY:

      1. [Скачайте](https://www.putty.org) и установите PuTTY.
      1. Добавьте папку с PuTTY в переменную `PATH`:

          <!-- source: ru/_includes/windows-environment-vars.md -->
          1. Нажмите кнопку **Пуск** и в строке поиска Windows введите **Изменение системных переменных среды**.
          1. Справа снизу нажмите кнопку **Переменные среды...**.
          1. В открывшемся окне найдите параметр `PATH` и нажмите **Изменить**.
          1. Добавьте путь к папке в список.
          1. Нажмите кнопку **ОК**.
          <!-- endsource: ru/_includes/windows-environment-vars.md -->

      1. Запустите приложение PuTTYgen.
      1. В качестве типа генерируемой пары выберите **EdDSA**. Нажмите **Generate** и поводите курсором в поле выше до тех пор, пока не закончится создание ключа.

          ![ssh_generate_key](../_assets/compute/ssh-putty/ssh_generate_key.png)

      1. В поле **Key passphrase** введите надежный пароль. Повторно введите его в поле ниже.
      1. Нажмите кнопку **Save private key** и сохраните закрытый ключ. Никому не сообщайте ключевую фразу от него.
      1. Нажмите кнопку **Save public key** и сохраните открытый ключ в файле `<имя_ключа>.pub`.
      <!-- endsource: ru/_includes/vm-ssh-prepare-key-win-7-8.md -->

    {% endlist %}

1. <!-- source: ru/_includes/turn-on-ssh-agent.md -->
   Запустите SSH-агент:

   {% list tabs group=operating_system %}

   - Linux/MacOS {#linux-macos}

      1. Выполните команду:

         ```bash
         ssh-agent -s
         ```

      1. Чтобы SSH-агент запускался при входе в систему, в файл `~/.profile` добавьте команду запуска:

         ```bash
         ssh-agent -s
         ```

   - Windows {#windows}

      1. Откройте контекстное меню кнопки **Пуск**.
      1. Выберите пункт **Управление компьютером**.
      1. Перейдите в раздел **Службы и приложения** → **Службы**.
      1. Откройте контекстное меню службы **SSH agent** и выберите пункт **Свойства**.
      1. На вкладке **Главное** измените тип запуска с **Выключена** на **Автоматически**.
      1. Нажмите кнопку **OK** и запустите службу.

   {% endlist %}
   <!-- endsource: ru/_includes/turn-on-ssh-agent.md -->
1. Добавьте ключ в агент SSH:

    ```bash
    ssh-add <путь_к_закрытому_ключу>
    ```
<!-- endsource: ru/_includes/sourcecraft/prepare-environment.md -->

Также вы можете получить доступ к репозиторию с помощью [персонального токена (PAT)](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/pat.md).

## Добавьте SSH-ключ в SourceCraft {#add-ssh}

<!-- source: ru/_includes/sourcecraft/double-ssh-error.md -->
{% note warning %}

SSH-ключ может быть привязан только к одному пользовательскому аккаунту. Попытка добавить SSH-ключ, который ранее был добавлен в SourceCraft другим пользователем, приведет к ошибке.

Если для авторизации в SourceCraft вы используете несколько разных [SAML-совместимых федераций удостоверений](https://yandex.cloud/ru/docs/organization/concepts/add-federation) Yandex Cloud или, например, федерацию и личный [Яндекс ID](https://id.yandex.ru/), добавьте разные SSH-ключи для каждого профиля.

{% endnote %}
<!-- endsource: ru/_includes/sourcecraft/double-ssh-error.md -->

<!-- source: ru/_includes/sourcecraft/add-ssh.md -->
1. Откройте [главную страницу сервиса](https://sourcecraft.dev).
1. На панели слева нажмите ![image](../_assets/console-icons/house.svg) **Домой** и перейдите в раздел ![image](../_assets/console-icons/lock.svg) **Доступ** → ![image](../_assets/console-icons/key.svg) **SSH-ключи**.
1. На странице **SSH-ключи** нажмите **Новый SSH ключ**:
    * В поле **Название ключа** укажите произвольное название ключа.
    * В поле **Значение** вставьте содержимое файла с открытым SSH-ключом.
1. Нажмите **Создать ключ**.
<!-- endsource: ru/_includes/sourcecraft/add-ssh.md -->

## Клонируйте репозиторий {#clone-repo}

<!-- source: ru/_includes/sourcecraft/clone-repo-ssh.md -->
1. [Установите Git](https://git-scm.com/downloads).
1. На странице репозитория в правом верхнем углу нажмите кнопку ![image](../_assets/console-icons/chevron-down-wide.svg) **Клонировать**.
1. Скопируйте ![image](../_assets/console-icons/copy.svg) ссылку для клонирования репозитория из поля **SSH**.
1. В терминале выполните команду:
    
    ```bash
    git clone <ссылка_для_клонирования_репозитория>
    ```

    Чтобы склонировать репозиторий через порт 443, укажите номер порта в URL:

    ```bash
    git clone ssh://ssh.sourcecraft.dev:443/<слаг_организации>/<слаг_репозитория>.git
    ```

    Например:

    ```bash
    git clone ssh://ssh.sourcecraft.dev:443/sourcecraft/sourcecraft.git
    ```

    Подробнее об использовании SSH через порт HTTPS в [документации на GitHub](https://docs.github.com/en/authentication/troubleshooting-ssh/using-ssh-over-the-https-port).

1. Перейдите в склонированный репозиторий:
    
   ```bash
   cd <имя_репозитория>
   ```
<!-- endsource: ru/_includes/sourcecraft/clone-repo-ssh.md -->

## Внесите изменения в новую ветку {#commit-push}

1. Создайте новую ветку для изменений и отправьте ее в удаленный репозиторий:

    ```bash
    git checkout -b new-feature
    git push -u origin new-feature
    ```

1. Внесите изменения в файлы репозитория. Например, отредактируйте файл `README.md`.
1. Внесите измененный файл в индекс `git`, сделайте коммит и отправьте изменения в удаленный репозиторий:

    ```bash
    git add .
    git commit -m "updated README.md"
    git push origin new-feature
    ```

## Предложите изменения {#create-pr}

1. На странице репозитория в SourceCraft в разделе ![image](../_assets/console-icons/code.svg) **Код** перейдите в секцию ![image](../_assets/console-icons/code-pull-request.svg) **Предложения изменений**.
1. В правом верхнем углу нажмите **Предложить изменения**.
1. В выпадающем списке **источник** выберите ветку `new-feature`, в **цель** — `main`.
1. (опционально) Укажите название и описание предложения изменений.
1. Нажмите **Опубликовать предложение изменений**.

## Выполните слияние с основной веткой {#merge-pr}

1. Чтобы посмотреть, что предлагается изменить, перейдите на вкладку ![image](../_assets/console-icons/file-code.svg) **Изменённые файлы**.
1. Одобрите изменения — в правом верхнем углу нажмите ![image](../_assets/console-icons/thumbs-up.svg) **Одобрить**.
1. Нажмите ![image](../_assets/console-icons/code-pull-request.svg) **Принять**.

## Полезные ссылки {#see-also}

* [Взаимосвязь ресурсов SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/index.md)
* [Управление доступом в SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/index.md)
* [Безопасность в SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/security-overview.md)
* [Импортировать, зеркалировать или синхронизировать репозиторий в SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/migration.md)
* [Настроить CI/CD в репозитории SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/ci-cd.md)
* [Непрерывная интеграция и непрерывное развертывание в SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ci-cd.md)
* [Настроить правила ревью кода в репозитории SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/code-review.md)
* [Правила ревью кода в SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/code-review.md)
* [Как начать работать с SourceCraft CLI](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/cli-quickstart.md)
* [Работа с REST API SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/api-start.md)

<!-- source: ru/_includes/sourcecraft/yandex-project.md -->
_[Проект Яндекса](https://yandex.ru/all)          © 2026 ООО «Яндекс.Облако»_
<!-- endsource: ru/_includes/sourcecraft/yandex-project.md -->