Bitbucket для начинающих

Полное руководство по платформе Atlassian для командной разработки

Время изучения: 25 мин Уровень: Средний Обновлено: Окт 2023

1
Что такое Bitbucket и экосистема Atlassian?

Bitbucket — это Git-хостинг от компании Atlassian, созданный специально для профессиональных команд. Его главное преимущество — глубокая интеграция с другими продуктами Atlassian: Jira, Confluence, Trello, Bamboo.

Ключевые особенности Bitbucket:

  • Бесплатные приватные репозитории для небольших команд (до 5 пользователей)
  • Bitbucket Pipelines — встроенный CI/CD для автоматической сборки и деплоя
  • Умные Pull Requests с код-ревью, проверкой кода и аппрувами
  • Интеграция с Jira — связь коммитов, веток и PR с задачами
  • Bitbucket Snippets — удобный обмен фрагментами кода
Что такое экосистема Atlassian?

Atlassian — компания, которая создаёт инструменты для командной работы. Основные продукты:

  • Jira — система отслеживания задач и проектов (особенно популярна в agile - командах)
  • Confluence — вики-система для документации
  • Trello — доски для управления проектами (куплен Atlassian)
  • Bitbucket — хостинг кода и CI/CD
  • Bamboo — CI/CD сервер (постепенно заменяется Bitbucket Pipelines)

Если ваша команда уже использует Jira для управления задачами, Bitbucket станет естественным выбором для хостинга кода.

Инструмент Atlassian Как интегрируется с Bitbucket Польза для разработчика
Jira Автоматическая связь коммитов и PR с задачами Видите историю изменений по задаче прямо в Jira
Confluence Встраивание кода из репозиториев в документацию Актуальные примеры кода в документации
Trello Привязка коммитов к карточкам Отслеживание прогресса разработки на доске
Bamboo Запуск сборок при пуше в репозиторий Непрерывная интеграция с собственным сервером

2
Регистрация и настройка первого проекта

Шаг 1: Регистрация на Bitbucket

  1. Перейдите на bitbucket.org
  2. Нажмите "Get started for free"
  3. Войдите через Google или зарегистрируйтесь с email
  4. Подтвердите email-адрес

Шаг 2: Создание репозитория

Bitbucket предлагает два типа репозиториев:

Приватный

Только вы и ваша команда видите код

Публичный

Виден всем, подходит для open-source

Для создания репозитория:

  1. Нажмите "Create" → "Repository"
  2. Укажите имя проекта (например, my-bitbucket-site)
  3. Выберите тип репозитория (рекомендуем начать с приватного)
  4. Отметьте "Include a README?" для создания начального файла
  5. Нажмите "Create repository"

Важно: Bitbucket не имеет прямого аналога GitHub Pages. Для хостинга сайта нужно настроить Bitbucket Pipelines или использовать сторонние сервисы (Netlify, Vercel).

3
Bitbucket Pipelines: CI/CD для хостинга сайтов

Bitbucket Pipelines — это встроенный CI/CD инструмент, который запускается при каждом коммите. Для хостинга статического сайта создайте файл bitbucket-pipelines.yml:

bitbucket-pipelines.yml - хостинг на S3
image: alpine:latest pipelines: default: - step: name: Deploy to S3 script: # Устанавливаем AWS CLI - apk add --no-cache aws-cli # Синхронизируем файлы с S3 bucket - aws s3 sync . $AWS_S3_BUCKET --delete caches: - pip

Этот конфиг загрузит файлы вашего сайта в AWS S3. Для работы нужно:

  1. Создать S3 bucket в AWS
  2. Настроить его для хостинга статических сайтов
  3. Добавить переменные AWS_ACCESS_KEY_ID и AWS_SECRET_ACCESS_KEY в настройках Pipelines

Интеграция с Jira: Магия автоматизации

1

Создайте задачу в Jira

Например, "Создать главную страницу сайта" (PROJ-123)

2

Создайте ветку в Bitbucket

Используйте имя задачи: feature/PROJ-123-homepage

3

Работайте над кодом

Делайте коммиты с упоминанием PROJ-123 в сообщении

4

Создайте Pull Request

В Jira автоматически появится ссылка на PR и все коммиты

Альтернатива: Хостинг через Netlify/Vercel

Если не хотите настраивать S3, можно использовать специализированные сервисы:

  1. Создайте аккаунт на Netlify или Vercel
  2. Подключите Bitbucket репозиторий
  3. Настройте автоматический деплой при пуше в главную ветку
  4. Получите готовый сайт с SSL и CDN

Этот способ проще для начинающих и предоставляет больше возможностей для фронтенд-фреймворков.

4
Умные Pull Requests и код-ревью

Approve

Одобрение изменений

Comments

Обсуждение кода

Tasks

Чек-листы в PR

Automation

Автоматические проверки

Как устроен Pull Request в Bitbucket?

Bitbucket предоставляет продвинутые инструменты для код-ревью:

  • Diff-просмотр — удобное сравнение изменений с подсветкой синтаксиса
  • Inline comments — комментарии к конкретным строкам кода
  • Approvals — обязательное одобрение определённых участников
  • Tasks — чек-лист задач, которые нужно выполнить перед мержем
  • Automatic merge — автоматическое слияние после выполнения условий
Совет: Настройте обязательные аппрувы для защищённых веток (main, develop). Это предотвратит мерж непроверенного кода.
Ограничения бесплатного тарифа

Бесплатный тариф Bitbucket Cloud имеет ограничения:

  • Пользователи: Максимум 5 пользователей в команде
  • CI/CD minutes: 50 минут в месяц для Bitbucket Pipelines
  • Storage: 1 GB на репозиторий (LFS — 1 GB)
  • Размер репозитория: 2 GB мягкое ограничение

Для небольших проектов и личного использования этого достаточно. Для коммерческих проектов с большей командой рассмотрите тариф Standard ($3/мес за пользователя).

Практическое задание: Сайт с Bitbucket Pipelines

Разверните статический сайт с помощью Bitbucket Pipelines:

Создайте приватный репозиторий на Bitbucket
Добавьте index.html и style.css с содержимым сайта
Создайте bitbucket-pipelines.yml для деплоя на Netlify или S3
Настройте переменные окружения для доступа к хостингу
Запушите изменения и проверьте работу пайплайна

Бонус: Настройте интеграцию с Jira (если есть аккаунт) и посмотрите, как коммиты отображаются в задаче

5
Кому подходит Bitbucket?

Выберите Bitbucket, если:

  • Ваша команда уже использует Jira, Confluence или другие инструменты Atlassian
  • Нужны бесплатные приватные репозитории для небольшой команды (до 5 человек)
  • Хотите встроенный CI/CD (Pipelines) без сложных настроек
  • Цените качественные инструменты для код-ревью и Pull Requests
  • Работаете в корпоративной среде, где важна интеграция инструментов

Может не подойти, если:

  • Нужен простой хостинг для статического сайта (лучше GitHub Pages)
  • Работаете над open-source проектом (сообщество GitHub больше)
  • Нужны продвинутые DevOps инструменты (лучше GitLab)
  • Хотите максимально простой и минималистичный интерфейс (лучше SourceHut)

Для углубленного изучения

Изучите официальную документацию Bitbucket и практические руководства.

Предыдущий урок
GitLab для начинающих
Следующий урок
SourceHut для начинающих