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

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

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

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

Совет

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

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

Подробнее на странице Настроить почту для ассоциации коммитов в SourceCraft.
Ветки — независимые линии разработки.
Теги — маркировка важных точек в истории проекта.
Релизы — зафиксированные версии проекта, включающие определенный набор изменений, тег, описание и дополнительные ресурсы, например бинарные файлы или архивы, предназначенные для пользователей или других разработчиков.

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

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

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

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

Откройте главную страницу сервиса.
На панели слева нажмите Создать репозиторий.
В открывшемся окне выберите Пустой репозиторий.
В блоке Сведения о новом репозитории:
- В поле Владелец выберите организацию, в которой будет создан репозиторий.
- В поле Название укажите название репозитория.
  
  Название должно быть уникальным в пределах организации и может содержать следующие ASCII-символы: строчные и заглавные буквы латинского алфавита, цифры, запятые, дефисы и подчеркивания.
  
  Под названием отображается адрес, по которому репозиторий будет доступен.
- (опционально) В поле Описание укажите описание репозитория.
В поле Видимость выберите тип доступа к репозиторию:
- Публичный — доступ к просмотру репозитория будут иметь все пользователи интернета без аутентификации. Доступ к изменению репозитория будут иметь только приглашенные пользователи.
- Внутренний — доступ к просмотру и изменению репозитория будут иметь только пользователи организации, в которой создан репозиторий.
- Приватный — доступ к просмотру и изменению репозитория будут иметь только приглашенные пользователи.
В любой момент вы можете изменить тип доступа к репозиторию.
(опционально) В блоке Настройки выберите:
- Сразу добавить 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.
Нажмите Создать репозиторий.

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

Совет

В этой инструкции описано создание репозитория из системного шаблона. О создании репозитория из пользовательского шаблона читайте на странице Работа с пользовательскими шаблонами репозиториев в SourceCraft.

Откройте главную страницу сервиса.
На панели слева нажмите Создать репозиторий.
В открывшемся окне выберите вкладку Пустой репозиторий.
В блоке Сведения о новом репозитории:
- В поле Владелец выберите организацию, в которой будет создан репозиторий.
- В поле Название укажите название репозитория.
  
  Название должно быть уникальным в пределах организации и может содержать следующие ASCII-символы: строчные и заглавные буквы латинского алфавита, цифры, запятые, дефисы и подчеркивания.
  
  Под названием отображается адрес, по которому репозиторий будет доступен.
- (опционально) В поле Описание укажите описание репозитория.
В блоке Шаблон репозитория нажмите Просмотр шаблонов, выберите подходящий шаблон репозитория и нажмите Использовать шаблон.

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

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

Полезные ссылки

Была ли статья полезна?

Управление ролями пользователей

Клонировать репозиторий