Git flow linux install

git-flow cheatsheet

efficient branching using git-flow by Vincent Driessen

About

git-flow are a set of git extensions to provide high-level repository operations for Vincent Driessen’s branching model. more

This cheatsheet shows the basic usage and effect of git-flow operations

Basic tips

• Git flow provides excellent command line help and output. Read it carefully to see what’s happening.
• The macOS/Windows Client Sourcetree is an excellent git gui and provides git-flow support
• Git-flow is a merge based solution. It doesn’t rebase feature branches.

Setup

• You need a working git installation as prerequisite.
• Git flow works on macOS, Linux and Windows

macOS

Linux

Windows (Cygwin)

$ wget -q -O — —no-check-certificate https://raw.github.com/petervanderdoes/gitflow-avh/develop/contrib/gitflow-installer.sh install stable | bash

You need wget and util-linux to install git-flow.

For detailed git flow installation instructions please visit the git flow wiki.

Getting started

Git flow needs to be initialized in order to customize your project setup.

Initialize

Start using git-flow by initializing it inside an existing git repository:

You’ll have to answer a few questions regarding the naming conventions for your branches.
It’s recommended to use the default values.

Features

• Develop new features for upcoming releases
• Typically exist in developers repos only

Start a new feature

Development of new features starting from the ‘develop’ branch.

Start developing a new feature with

git flow feature start MYFEATURE

This action creates a new feature branch based on ‘develop’ and switches to it

Finish up a feature

Finish the development of a feature. This action performs the following

• Merges MYFEATURE into ‘develop’
• Removes the feature branch
• Switches back to ‘develop’ branch

git flow feature finish MYFEATURE

Publish a feature

Are you developing a feature in collaboration?
Publish a feature to the remote server so it can be used by other users.

git flow feature publish MYFEATURE

Getting a published feature

Get a feature published by another user.

git flow feature pull origin MYFEATURE

You can track a feature on origin by using

git flow feature track MYFEATURE

Make a release

• Support preparation of a new production release
• Allow for minor bug fixes and preparing meta-data for a release

Start a release

To start a release, use the git flow release command. It creates a release branch created from the ‘develop’ branch.

git flow release start RELEASE [BASE]

You can optionally supply a [BASE] commit sha-1 hash to start the release from. The commit must be on the ‘develop’ branch.

It’s wise to publish the release branch after creating it to allow release commits by other developers. Do it similar to feature publishing with the command:

git flow release publish RELEASE

(You can track a remote release with the
git flow release track RELEASE command)

Finish up a release

Finishing a release is one of the big steps in git branching. It performs several actions:

• Merges the release branch back into ‘master’
• Tags the release with its name
• Back-merges the release into ‘develop’
• Removes the release branch

git flow release finish RELEASE

Don’t forget to push your tags with git push origin —tags

Hotfixes

• Hotfixes arise from the necessity to act immediately upon an undesired state of a live production version
• May be branched off from the corresponding tag on the master branch that marks the production version.

git flow hotfix start

Like the other git flow commands, a hotfix is started with

git flow hotfix start VERSION [BASENAME]

The version argument hereby marks the new hotfix release name. Optionally you can specify a basename to start from.

Finish a hotfix

By finishing a hotfix it gets merged back into develop and master. Additionally the master merge is tagged with the hotfix version.

git flow hotfix finish VERSION

Commands

Backlog

• Not all available commands are covered here, only the most important ones
• You can still use git and all its commands normally as you know them, git flow is only a tooling collection
• The ‘support’ feature is still beta, using it is not advised
• If you’d like to supply translations I’d be happy to integrate them

Источник

Шпаргалка по git-flow

эффективное ветвление с помощью git-flow от Vincent Driessen

Введение

git-flow — это набор расширений git предоставляющий высокоуровневые операции над репозиторием для поддержки модели ветвления Vincent Driessen. узнать больше

Эта шпаргалка показывает основные способы использования операций git-flow.

Общие замечания

• Git flow предоставляет превосходную командную строку со справкой и улучшенными выводом. Внимательно читайте его, чтобы знать, что происходит.
• Клиент для macOS/Windows Sourcetree — отличный GUI для Git — также поддерживает git-flow
• Git-flow основан на слиянии. Для слияния веток фич не используется rebase.

Установка

• В первую очередь вам нужна рабочая установка git
• Git flow работает на macOS, Linux и Windows

macOS

Linux

Windows (Cygwin)

$ wget -q -O — —no-check-certificate https://raw.github.com/petervanderdoes/gitflow-avh/develop/contrib/gitflow-installer.sh install stable | bash

Вам потребуется wget и util-linux для установки git-flow.

Подробные инструкции по установке git flow смотрите на git flow wiki.

Приступая к работе

Git flow нужно инициализировать, чтобы настроить его для работы с вашим проектом.

Инициализация

Для начала использования git-flow проинициализируйте его внутри существующего git-репозитория:

Вам придётся ответить на несколько вопросов о способах именования ваших веток.
Рекомендуется оставить значения по умолчанию.

• Разработка новых фич для последующих релизов
• Обычно присутствует только в репозиториях разработчиков

Начало новой фичи

Разработка новых фич начинается из ветки «develop».

Для начала разработки фичи выполните:

git flow feature start MYFEATURE

Это действие создаёт новую ветку фичи, основанную на ветке «develop», и переключается на неё.

Завершение фичи

Окончание разработки фичи. Это действие выполняется так:

• Слияние ветки MYFEATURE в «develop»
• Удаление ветки фичи
• Переключение обратно на ветку «develop»

git flow feature finish MYFEATURE

Публикация фичи

Вы разрабатываете фичу совместно с коллегами?
Опубликуйте фичу на удалённом сервере, чтобы её могли использовать другие пользователи.

git flow feature publish MYFEATURE

Получение опубликованной фичи

Получение фичи, опубликованной другим пользователем.

git flow feature pull origin MYFEATURE

Вы можете отслеживать фичу в репозитории origin с помощью команды git flow feature track MYFEATURE

Создание релиза

• Поддержка подготовки нового релиза продукта
• Позволяет устранять мелкие баги и подготавливать различные метаданные для релиза

Начало релиза

Для начала работы над релизом используйте команду git flow release Она создаёт ветку релиза, ответляя от ветки «develop».

git flow release start RELEASE [BASE]

При желании вы можете указать [BASE] -коммит в виде его хеша sha-1, чтобы начать релиз с него. Этот коммит должен принадлежать ветке «develop».

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

git flow release publish RELEASE

Вы также можете отслеживать удалённый релиз с помощью команды
git flow release track RELEASE

Завершение релиза

Завершение релиза — один из самых больших шагов в git-ветвлени. При этом происходит несколько действий:

• Ветка релиза сливается в ветку «master»
• Релиз помечается тегом равным его имени
• Ветка релиза сливается обратно в ветку «develop»
• Ветка релиза удаляется

git flow release finish RELEASE

Не забудьте отправить изменения в тегах с помощью команды git push —tags

Исправления

• Исправления нужны в том случае, когда нужно незамедлительно устранить нежелательное состояние продакшн-версии продукта
• Может ответвляться от соответствующего тега на ветке «master», который отмечает выпуск продакшн-версии

git flow hotfix start

Как и в случае с другими командами git flow, работа над исправлением начинается так:

git flow hotfix start VERSION [BASENAME]

Аргумент VERSION определяет имя нового, исправленного релиза.

При желании можно указать BASENAME-коммит, от которого произойдёт ответвление.

Завершение исправления

Когда исправление готово, оно сливается обратно в ветки «develop» и «master». Кроме того, коммит в ветке «master» помечается тегом с версией исправления.

git flow hotfix finish VERSION

Команды

Последние замечания

• Здесь описаны не все доступные команды, только наиболее важные
• Вы можете продолжать использовать git и все его команды, как обычно, git flow — это просто набор дополнительных инструментов
• Возможности «support»-веток пока в beta-версии, использовать их не рекомендуется

Источник

Git flow linux install

A collection of Git extensions to provide high-level repository operations for Vincent Driessen’s branching model.

For the best introduction to get started with git flow , please read Jeff Kreeftmeijer’s blog post:

Or have a look at one of these screen casts:

If you’re on a Mac and use homebrew, it’s simple:

If you’re on a Mac and use MacPorts, it’s simple:

Another easy way to install git-flow is using Rick Osborne’s excellent git-flow installer, which can be run using the following command:

For Windows users who wish to use the automated install, it is suggested that you install Cygwin first to install tools like git , util-linux and wget (with those three being packages that can be selected during installation). Then simply run this command from a Cygwin shell:

This is much like the manual installation below, but there are additional steps required to install some extra tools that are not distributed with msysgit.

Clone the git-flow sources from Github:

Copy git-flow’s relevant files to your msysgit installation directory:

Next up we need to borrow a couple of binaries from Cygwin. If you don’t have Cygwin installed, please install it including the util-linux package. Apart from util-linux ‘s dependencies, no other packages are required. When you finished installation, copy the following files using msysgit’s Git Bash. We assume the Cygwin’s default installation path in C:\cygwin.

After copying the files above, you can safely uninstall your Cygwin installation by deleting the C:\cygwin directory.

If you prefer a manual installation, please use the following instructions:

Then, you can install git-flow , using:

By default, git-flow will be installed in /usr/local. To change the prefix where git-flow will be installed, simply specify it explicitly, using:

Or simply point your PATH environment variable to your git-flow checkout directory.

Installation note:
git-flow depends on the availability of the command line utility getopt , which may not be available in your Unix/Linux environment. Please use your favorite package manager to install getopt . For Cygwin, install the util-linux package to get getopt . If you use apt-get as your install manager, the package name is opt .

Integration with your shell

For those who use the Bash or ZSH shell, please check out the excellent work on the git-flow-completion project by bobthecow. It offers tab-completion for all git-flow subcommands and branch names.

For Windows users, msysgit is a good starting place for installing git.

See the FAQ section of the project Wiki.

Please help out

This project is still under development. Feedback and suggestions are very welcome and I encourage you to use the Issues list on Github to provide that feedback.

Feel free to fork this repo and to commit your additions. For a list of all contributors, please see the AUTHORS file.

Any questions, tips, or general discussion can be posted to our Google group: http://groups.google.com/group/gitflow-users

git-flow is published under the liberal terms of the BSD License, see the LICENSE file. Although the BSD License does not require you to share any modifications you make to the source code, you are very much encouraged and invited to contribute back your modifications to the community, preferably in a Github fork, of course.

To initialize a new repo with the basic branch structure, use:

This will then interactively prompt you with some questions on which branches you would like to use as development and production branches, and how you would like your prefixes be named. You may simply press Return on any of those questions to accept the (sane) default suggestions.

Creating feature/release/hotfix/support branches

To list/start/finish feature branches, use:

For feature branches, the arg must be a commit on develop .

To list/start/finish release branches, use:

For release branches, the arg must be a commit on develop .

To list/start/finish hotfix branches, use:

For hotfix branches, the arg must be a commit on master .

To list/start support branches, use:

For support branches, the arg must be a commit on master .

Showing your appreciation

A few people already requested it, so now it’s here: a Flattr button.

Of course, the best way to show your appreciation for the original blog post or the git-flow tool itself remains contributing to the community. If you’d like to show your appreciation in another way, however, consider Flattr’ing me:

Источник