Создать репозиторий в SourceCraft

Репозиторий — это хранилище, в котором находится весь код проекта и связанная с ним информация. Репозиторий включает в себя:

  • исходный код — все файлы проекта;
  • историю изменений — лог коммитов;
  • ветки — независимые линии разработки;
  • теги — маркировка важных точек в истории проекта.

Репозиторий позволяет отслеживать развитие проекта, управлять разными ветками разработки и возвращаться к предыдущим версиям кода.

Доступны следующие варианты создания репозитория:

Создать пустой репозиторий

  1. Откройте главную страницу сервиса.
  2. На панели слева нажмите Создать репозиторий.
  3. В открывшемся окне выберите Создать пустой репозиторий.
  4. В блоке Сведения о новом репозитории:

    • В поле Владелец выберите организацию, в которой будет создан репозиторий.

    • В поле Название укажите название репозитория.

      Название должно быть уникальным в пределах организации и может содержать следующие ASCII-символы: строчные и заглавные буквы латинского алфавита, цифры, запятые, дефисы и подчеркивания.

      Под названием отображается адрес, по которому репозиторий будет доступен.

    • (опционально) В поле Описание укажите описание репозитория.

  5. В поле Видимость выберите тип доступа к репозиторию:

    • Приватный — доступ к просмотру и изменению репозитория будут иметь только приглашенные пользователи.

    • Публичный — доступ к просмотру репозитория будут иметь все пользователи интернета без аутентификации. Доступ к изменению репозитория будут иметь только приглашенные пользователи.

      Важно

      SourceCraft ограниченно доступен по запросу на стадии стадии Preview. Соответственно, просмотр публичных репозиториев доступен только пользователям, имеющим доступ к SourceCraft. После того, как сервис станет доступен для всех, публичные репозитории будут доступны к просмотру всем пользователям интернета без аутентификации.

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

  6. (опционально) В блоке Настройки выберите:
    • Добавить первым README — для добавления в репозиторий файла README.md с описанием проекта.

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

      Чтобы использовать шаблоны для .gitignore:

      • Раскройте выпадающий список.
      • В поисковой строке введите язык программирования или фреймворк, которые вы хотите использовать для разработки.
      • Последовательно выберите все подходящие шаблоны.
    • Добавить лицензию — для добавления в репозиторий файла LICENSE с лицензией проекта.

      Чтобы использовать шаблон для LICENSE:

      • Раскройте выпадающий список.
      • В поисковой строке введите название лицензии.
    • Добавить шаблон cicd — для добавления в репозиторий файла .src.yaml с конфигурацией CI/CD.

      Чтобы использовать шаблон для .src.yaml, раскройте выпадающий список и выберите подходящую конфигурацию CI/CD.

      Подробнее о CI/CD см. на странице Настроить CI/CD в репозитории SourceCraft.

  7. Нажмите Создать репозиторий.

Создать репозиторий из шаблона

  1. Откройте главную страницу сервиса.
  2. На панели слева нажмите Создать репозиторий.
  3. В открывшемся окне выберите Создать пустой репозиторий.
  4. В блоке Сведения о новом репозитории:

    • В поле Владелец выберите организацию, в которой будет создан репозиторий.

    • В поле Название укажите название репозитория.

      Название должно быть уникальным в пределах организации и может содержать следующие ASCII-символы: строчные и заглавные буквы латинского алфавита, цифры, запятые, дефисы и подчеркивания.

      Под названием отображается адрес, по которому репозиторий будет доступен.

    • (опционально) В поле Описание укажите описание репозитория.

  5. В блоке Шаблон репозитория нажмите Просмотр шаблонов, выберите подходящий шаблон репозитория и нажмите Использовать шаблон.

    Шаблоны содержат предустановленную конфигурацию CI/CD, а также типовые файлы проекта.

    Чтобы посмотреть содержимое шаблона, нажмите Предварительный просмотр.

  6. В поле Видимость выберите тип доступа к репозиторию:

    • Приватный — доступ к просмотру и изменению репозитория будут иметь только приглашенные пользователи.

    • Публичный — доступ к просмотру репозитория будут иметь все пользователи интернета без аутентификации. Доступ к изменению репозитория будут иметь только приглашенные пользователи.

      Важно

      SourceCraft ограниченно доступен по запросу на стадии стадии Preview. Соответственно, просмотр публичных репозиториев доступен только пользователям, имеющим доступ к SourceCraft. После того, как сервис станет доступен для всех, публичные репозитории будут доступны к просмотру всем пользователям интернета без аутентификации.

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

  7. Нажмите Создать репозиторий.

См. также