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

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

  • Исходный код — все файлы проекта.

  • Коммиты — записи об изменениях в репозитории с описанием, данными автора и временной меткой.

    Подробнее см. на странице Посмотреть историю коммитов в SourceCraft.

    Совет

    SourceCraft получает имя и почту автора коммита из git. Если почта в настройках git совпадает с почтой пользователя SourceCraft, то такой коммит ассоциируется в репозитории с этим пользователем — в истории коммитов отображаются имя пользователя в SourceCraft, аватар и ссылка на профиль.

    Вы можете ассоциировать со своим профилем несколько адресов почты, тогда коммиты, содержащие эти адреса, будут закреплены за вашим профилем.

    Подробнее см. на странице Настроить почту для ассоциации коммитов в SourceCraft.

  • Ветки — независимые линии разработки.

  • Теги — маркировка важных точек в истории проекта.

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

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

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

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

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

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

  4. В блоке Сведения о новом репозитории:

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

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

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

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

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

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

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

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

  6. (опционально) В блоке Настройки выберите:

    • Сразу добавить README — для добавления в репозиторий файла README.md с описанием проекта.

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

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

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

    • Добавить лицензию — для добавления в репозиторий файла LICENSE с лицензией проекта.

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

      • Раскройте выпадающий список.
      • В поисковой строке введите название лицензии.

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

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

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

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

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

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

  4. В блоке Сведения о новом репозитории:

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

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

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

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

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

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

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

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

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

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

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

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

См. также

Предыдущая
Удалить аккаунт и персональную организацию
Следующая
Клонировать репозиторий