release management -...

WITH GRADLE

RELEASE MANAGEMENT

@tolkv

2

@lavcraft

Чего не будет

3

Чего не будет● Релизь чаще — будет счастье!

4

● Релизь чаще — будет счастье!● Каждый коммит — релиз

5


● Релизь чаще — будет счастье!● Каждый коммит — релиз● Автоматизируй все

6


● Релизь чаще — будет счастье!● Каждый коммит — релиз● Автоматизируй все● Сделано — значит зарелижено

7


8

Что будет

● Жизненный цикл скриптов сборки

9

Что будет

Что будет● Жизненный цикл скриптов сборки● Основные проблемы

10

● Жизненный цикл скриптов сборки● Основные проблемы● Инструменты для решения

11

Что будет

● Жизненный цикл скриптов сборки● Основные проблемы● Инструменты для решения● Императивный vs декларативный Gradle

12

Что будет

● Жизненный цикл скриптов сборки● Основные проблемы● Инструменты для решения● Императивный vs декларативный Gradle● Можно ли превратиться из Зерга в Протосса

13

Что будет

Где мы

Bin

GIT CI Dev

Prod14

Bin

GIT CI Dev

Prod15

Где мы

Bin

GIT CI Dev

Prod16

Где мы

Плохой код

17

Плохой билдскрипт

18

Стратегия успеха

19

Что нужно сделать

20

Что нужно сделать● Добыть ресурсов

21

Что нужно сделать● Добыть ресурсов● Подготовить базу

22

Что нужно сделать● Добыть ресурсов● Подготовить базу● Создать армию

23

Что нужно сделать● Добыть ресурсов● Подготовить базу● Создать армию● Укрепить позиции

24

Что нужно сделать● Добыть ресурсов● Подготовить базу● Создать армию● Укрепить позиции● Захватить мир

25

● Кто писал “скрипты сборки”?

26

Все еще собираете?

● Кто писал “скрипты сборки” с нуля?

27


● Кто писал “скрипты сборки” с нуля?● А кто правил существующие?

28


● Кто писал “скрипты сборки” с нуля?● А кто правил существующие?● По какому принципу пишут логику сборки?

29


● Кто писал “скрипты сборки” с нуля?● А кто правил существующие?● По какому принципу пишут логику сборки?● Правильно - по остаточному принципу

30


● build.gradle

31

Готовимся собирать

● build.gradle● settings.gradle

32


● build.gradle● settings.gradle● ./gradlew

33


Добываем инструменты

$ gradle wrapper --gradle-version 3.1

34

$ gradle wrapper --gradle-version 3.1

:wrapperBUILD SUCCESSFUL

Total time: 1.835 secs

35


$ ./gradlew init

36


$ ./gradlew init:wrapper:init

BUILD SUCCESSFUL


37


Добыли

$ lsbuild.gradlegradlegradlewgradlew.batsettings.gradle

38

$ lsbuild.gradlegradle/gradlewgradlew.batsettings.gradle

39

Добыли


40

Добыли


41

Добыли


42

Добыли

Добываем ресурсы

● Соберем./gradlew build

43


● Получилиls ./build/libs/project_name.jar

44



● Получилиls ./build/libs/project_name.jar

Где версия?45


Где моя версия, чувак?

$ cat build.gradle | grep version

46



Ничего!

47



Ничего!

$ echo "version = '1.0.1'" >> build.gradle

48



Ничего!

$ echo "version = '1.0.1'" >> build.gradle

$ ./gradlew clean build$ ls build/libs/

project_name-1.0.1.jar

49


● Указывать вручную./gradlew -Pversion=1.3.4-SNAPSHOT./gradlew -Pversion=1.3.4-Ы

50

● Брать из файлаversion = file("version.prop").text

51


Версия?

● Git/Metadataversion = new CustomVersion()

.loadFrom(file("version.prop"))

.appVersion()

52

53

- Версия хранится в файле в git

Версия?

54

- Версия хранится в файле в git- Синхронизировали версию - коммит

Версия?

- Версия хранится в файле в git- Синхронизировали версию - коммит- Осложняется поиск по нужной версии

55

Версия?

Будь как зерг

● Zerg Rush?

56

● Zerg Rush?● google.com: gradle problem_name solution

57


● Zerg Rush?● google.com: gradle problem_name solution● Copy/Pastе into build.gradle

58


● Zerg Rush?● google.com: gradle problem_name solution● Copy/Paste into build.gradle

59


● GrGitversion = GrGit.open(file("."))

.head()

.abbreviatedId

60


● GrGitversion = GrGit.open(file("."))

.head()

.abbreviatedId● Не закоммитил – нет новой версии

61


1: task release {2: doFirst {3: grgit.tag.add {4: name = version5: message = "Release of ${version}"6: }7: }8: }

Что делать с Git?

62

Порядок запуска

63

1. Task definition


64

1. Task definition

1: task release(type: Copy) {2: from(file('srcDir'))3: into(buildDir)4: }


65

1. Task definition

Task doFirstTask doFirst2. Task doFirst

1: task release(type: Copy) {2: from(file('srcDir'))3: into(buildDir)4: doFirst {//doing sth #1}5: doFirst {//doing sth #2}


66

1. Task definition


Task doFirstTask doFirst3. Task doLast

1: task release(type: Copy) {2: from(file('srcDir'))3: into(buildDir)4: doFirst {//doing sth #1}5: doFirst {//doing sth #2}7: doLast {//doing sth #3}8: doLast {//doing sth #4}9: }


67

1. Task definition



1: task release(type: Copy) {2: from(file('srcDir'))3: into(buildDir)4: doFirst {//doing sth #1}5: doFirst {//doing sth #2}7: doLast {//doing sth #3}8: doLast {//doing sth #4}9: }9: release.doLast {//do...#5}


68

1. Task definition



1: task release(type: Copy) {2: from(file('srcDir'))3: into(buildDir)4: doFirst {//doing sth #1}5: doFirst {//doing sth #2}7: doLast {//doing sth #3}8: doLast {//doing sth #4}9: }9: release.doLast {//do...#5}10:release << {//do...#6}

1: task preRelease {2: ...

Или с Gradle

69

1: task preRelease {2: doFirst {4: def br = file(".git/HEAD").text - "ref: refs/head/"

70

Или с Gradle

1: println "ref: refs/head/master" - "ref: refs/head/"

71

Groovy...

1: println "ref: refs/head/master" - "ref: refs/head/" > "master "

72

Groovy...

1: task preRelease {2: doFirst {4: def br = file(".git/HEAD").text - "ref: refs/head/"

73

Или с Gradle

1: task preRelease {2: doFirst {4: def br = file(".git/HEAD").text - "ref: refs/head/" 5: def cid = file(".git/refs/heads/$br").text"

74

Или с Gradle

1: task preRelease {2: doFirst {4: def br = file(".git/HEAD").text - "ref: refs/head/" 5: def cid = file(".git/refs/heads/$br").text" 6: def tag = grgit.tag.list()7: .first()8: .getName()

75

Или с Gradle

1: task preRelease {2: doFirst {4: def br = file(".git/HEAD").text - "ref: refs/head/" 5: def cid = file(".git/refs/heads/$br").text" 6: def tag = grgit.tag.list()7: .first()8: .getName()9: version = tag + br && cid ? "-$br-$cid":"" 10:}11:tasks.release.dependsOn preRelease

76

Или с Gradle

Итогоv1.0.1-master-a6f5ac0677421f486bd273ba4016e51b7634afa9

77

v1.0.1-master-a6f5ac0677421f486bd273ba4016e51b7634afa9

● uncommitted

78

Итого


● uncommitted● release

79

Итого


● uncommitted● release● dependencies

80

Итого

Метаданныеjar {

manifest { attributes(

"Manifest-Version" : "1.0","Implementation-Version": version,

) }

}

81

jar { manifest {

attributes(["Manifest-Version" :"1.0", "Implementation-Version":version,] << System.getenv()

) }

}

82

Метаданные

Manifest-Version: 1.0Implementation-Title: ru.joker.demo#app;0.3.0-rc.2Module-Origin: ssh://git@git/joker/demo-app.gitBuild-Date: 2016-08-11_07:09:52Build-Id: LOCALImplementation-Version: 0.3.0-rc.2Build-Number: LOCALBuilt-By: tolkvChange: 18d2261Module-Source: /appBranch: masterSpring-Boot-Version: 1.3.6.RELEASEBuilt-Status: integrationGradle-Version: 2.13Build-Job: LOCALBuilt-OS: Mac OS XX-Compile-Target-JDK: 1.8Build-Host: tolkv-workStart-Class: ru.sense.user.UserApplicationX-Compile-Source-JDK: 1.8Created-By: 1.8.0_60-b27 (Oracle Corporation)Build-Java-Version: 1.8.0_60

Manifest.mf

83

Manifest-Version: 1.0Implementation-Title: ru.joker.demo#app;0.3.0-rc.2Module-Origin: ssh://git@git/joker/demo-app.gitBuild-Date: 2016-08-11_07:09:52Build-Id: LOCALImplementation-Version: 0.3.0-rc.2Build-Number: LOCALBuilt-By: tolkvChange: 18d2261Module-Source: /appBranch: masterSpring-Boot-Version: 1.3.6.RELEASEBuilt-Status: integrationGradle-Version: 2.13Build-Job: LOCALBuilt-OS: Mac OS XX-Compile-Target-JDK: 1.8Build-Host: tolkv-workStart-Class: ru.sense.user.UserApplicationX-Compile-Source-JDK: 1.8Created-By: 1.8.0_60-b27 (Oracle Corporation)Build-Java-Version: 1.8.0_60

Manifest.mf

84

Еще полезные ресурсы

85

● информация об окружении сборки +X LOC

● информация об окружении сборки +X LOC● автор +Y LOC

86


● информация об окружении сборки +X LOC● автор +Y LOC● git окружение в manifest +Z LOC● publish* +M LOC

87


● информация об окружении сборки +X LOC● автор +Y LOC● git окружение в manifest +Z LOC● publish* +M LOC

Все это в build.gradle88


● от 3х строчек

build.gradle

89

● от 3х строчек● до 2000

90

build.gradle

● от 3х строчек● до 2000● за 30 минут

91

build.gradle

● от 3х строчек● до 2000● за 30 минут● типичная история

92

build.gradle

Как повторить это все?

93

94

● в другой команде


95

● в другой команде● на другом проекте


Думай как зерг!

96

build.gradle:apply from: "http://someorg.com/version.gradle"

Copy apply подход

97

build.gradle:apply from: "http://someorg.com/version.gradle"apply from: "http://someorg.com/maven.gradle"

98


http://someorg.com/version.gradle



build.gradle:apply from: "http://someorg.com/version.gradle"apply from: "http://someorg.com/maven.gradle"apply from: "http://someorg.com/check.gradle"

99



http://someorg.com/maven.gradle

build.gradle:apply from: "http://someorg.com/version.gradle"apply from: "http://someorg.com/maven.gradle"apply from: "http://someorg.com/check.gradle"apply from: "http://someorg.com/findbugs.gradle"apply from: "http://someorg.com/verify.gradle"apply from: "http://someorg.com/publish.gradle"apply from: "http://someorg.com/awesome!.gradle"

100




http://someorg.com/check.gradle




http://someorg.com/awesome!.gradle

build.gradle:apply from: "http://someorg.com/version.gradle"apply from: "http://someorg.com/maven.gradle"apply from: "http://someorg.com/check.gradle"apply from: "http://someorg.com/findbugs.gradle"apply from: "http://someorg.com/verify.gradle"apply from: "http://someorg.com/publish.gradle"apply from: "http://someorg.com/awesome!.gradle"apply from: "http://someorg.com/v1/awesome!.gradle"

101








http://someorg.com/awesome!.gradle

Проблема актуальна● Статичные зависимости для Сборки

102

● Статичные зависимости для Сборки● Что если сломался или недоступен

http://someorg.com/awesome.gradle?

103

Проблема актуальна

http://ext.ru/awesome.gradle


● Статичные зависимости для Сборки● Что если сломался или недоступен

http://someorg.com/awesome.gradle?● Нужен принципиально новый подход

104

Проблема актуальна



Новый подходИмперативность vs декларативность

● Статус проекта

105

Императивность vs декларативность

● Статус проекта● Сложность проекта

106



● Статус проекта● Сложность проекта● Поддержка

107



● Статус проекта● Сложность проекта● Поддержка● Перспективы

108


Декларативность● Безопасно

109

● Безопасно● Легко поддерживаемо

110

Декларативность

● Безопасно● Легко поддерживаемо● Понятно

111

Декларативность

apply from: .../version.gradle"apply from: .../maven.gradle"apply from: .../check.gradle"apply from: .../findbugs.gradle"apply from: .../verfify.gradle"apply from: .../publish.gradle"apply from: .../awesome!.gradle"

Декларативный подход

apply plugin: "yourplugin"

112

build.gradle:apply plugin: "version.plugin"apply plugin: "maven.plugin"apply plugin: "check.plugin"apply plugin: "findbugs.plugin"apply plugin: "verfify.plugin"apply plugin: "publish.plugin"apply plugin: "awesome.plugin"

113

Декларативный подход

Настраиваем каждый плагин:● информация об окружении сборки +X LOC● автор +Y LOC● git окружение в manifest +Z LOC● publish* +M LOC

Все это в build.gradle

Опять на те же грабли

114

Композиция плагинов

115

Сила в композицииapply plugin: "your.plugin.all" //2.1.+

116

●class MyPlugin implements Plugin<Project> { void apply(Project project) { project.plugins.apply( ResolveProjectVersoinPlugin) }}

117

Сила в композиции

●class MyPlugin implements Plugin<Project> { void apply(Project project) { project.plugins.apply( ResolveProjectVersoinPlugin) project.plugins.apply( AddGitTagPlugin) }}

118


●class MyPlugin implements Plugin<Project> { void apply(Project project) { project.plugins.apply( ResolveProjectVersoinPlugin) project.plugins.apply( AddGitTagPlugin) project.plugins.apply( UserInfoPlugin) }}

119


●class MyPlugin implements Plugin<Project> { void apply(Project project) { project.plugins.apply( ResolveProjectVersoinPlugin) project.plugins.apply( AddGitTagPlugin) project.plugins.apply( UserInfoPlugin) project.plugins.apply( DependencyLockPlugin)

}}

120


●class MyPlugin implements Plugin<Project> { void apply(Project project) { project.plugins.apply( ResolveProjectVersoinPlugin) project.plugins.apply( AddGitTagPlugin) project.plugins.apply( UserInfoPlugin) project.plugins.apply( DependencyLockPlugin) project.tasks.withType(Test) { Test testTask -> testTask.minHeapSize = '32m' testTask.maxHeapSize = '256m' testTask.jvmArgs "-XX:MaxPermSize=512m" testTask.jacocoTestReport.executionData += files(...) testTask.testLogging.exceptionFormat = 'full' } }}

121


apply plugin: "nebula.nebula-release"

● управление Git● управление номером версии● контроль за состоянием

репозитория

122


$ ./gradlew snapshot / devSnapshot$ ./gradlew candidate$ ./gradlew final

Inferred project: ws, version: 0.18.0-dev.0.uncommitted+3791c32

Что получили

123

Inferred project: joker-demo-project, version: 0.18.0-dev.0.uncommitted+3791c32

124



Легко найти негодяя

125



Легко найти негодяя Если есть метаинформация

126


$ ./gradlew final* What went wrong:An exception occurred applying plugin request [id: 'nebula.nebula-release', version: '4.0.1']> Failed to apply plugin [id 'nebula.nebula-release'] > Final and candidate builds require all changes to be committed into Git.

127


$ git tagv0.8.3v0.9.0v0.9.1v0.10.0-rc.1v0.10.0-rc.2v0.10.0v0.14.0v0.15.0v0.16.0v0.17.0

128


$ ./gradlew final…BUILD SUCCESSFUL

$ git tag … v0.16.0v0.17.0v0.18.0 # <--- new version

129


$ gw final -Prelease.scope=patch…BUILD SUCCESSFUL

$ git tag … v0.16.0v0.17.0v0.18.0v0.18.1 # <--- new version

130


● commit all for release check

Что еще

131

● commit all for release check● push to origin check

132

Что еще

● commit all for release check● push to origin check● add tags

133

Что еще

● commit all for release check● push to origin check● add tags● resolve version from tags and env

134

Что еще

● commit all for release check● push to origin check● add tags● resolve version from tags● tag in CI● tag in local● tag push

135

Что еще

Доставляемif [ "$TRAVIS_PULL_REQUEST" != "false" ]; then

./gradlew build

136

if [ "$TRAVIS_PULL_REQUEST" != "false" ]; then

./gradlew build

elif [ "$TRAVIS_PULL_REQUEST" == "false" ] && [ "$TRAVIS_TAG" == "" ]; then

./gradlew -Prelease.travisci=true snapshot

137

Доставляем


./gradlew build



elif [ "$TRAVIS_PULL_REQUEST" == "false" ] && [ "$TRAVIS_TAG" != "" ]; then

case "$TRAVIS_TAG" in

*-rc\.*)

./gradlew -Prelease.travisci=true -Prelease.useLastTag=true candidate ;;

*)

./gradlew -Prelease.travisci=true -Prelease.useLastTag=true final

publishPlugins ;;

esac ... 138



./gradlew build



elif [ "$TRAVIS_PULL_REQUEST" == "false" ] && [ "$TRAVIS_TAG" != "" ]; then

case "$TRAVIS_TAG" in

*-rc\.*)

./gradlew -Prelease.travisci=true -Prelease.useLastTag=true candidate ;;

*)


publishPlugins ;;

esac ... 139


Императивный подход● Классика Gradle

140

● Классика Gradle● Опасное ружье

141

Императивный подход

● Классика Gradle● Опасное ружье● Сложно контролировать

142

Императивный подход

Контроль● CheckStyle

143

● CheckStyle● PMD

144

Контроль

● CheckStyle● PMD● Codenarc

145

Контроль

● CheckStyle● PMD● Codenarc● Nebula Lint Plugin

146

Контроль

Gradle Linter

147

dependencies { compile 'org.slf4j:slf4j-api:1.7.21' compile group:'junit', name:'junit', version:'+'}

148

plugins { id 'nebula.lint' version '5.1.0'}

gradleLint.rules = ['all-dependency']


Gradle Linter

149

$ ./gradlew build…

this dependency is unused and can be removedwarning unused-dependency build.gradle:13compile 'org.slf4j:slf4j-api:1.7.21'

✖ build.gradle: 2 problems (0 errors, 2 warnings)

To apply fixes automatically, run fixGradleLint, review, and commit the changes.

Gradle Linter

150


this dependency is unused and can be removedwarning unused-dependency build.gradle:13compile 'org.slf4j:slf4j-api:1.7.21'



Gradle Linter

151

$ ./gradlew build fixGradleLint…

Corrected 2 lint problems

BUILD SUCCESSFUL


Gradle Linter

Сделать приятно всем?

152

153

● приятно


154

● приятно● потому что можем


155

● приятно● потому что можем● gradle позволяет


156

Кто нам поможет?

Сделать приятно всем!

157

Кто нам поможет?$HOME_DIR/.gradle/init.gradle


158

~/.gradle/init.gradle:

allprojects { apply plugin: GradleLintPlugin gradleLint.rules = [ 'all-dependency', 'dependency-parentheses', 'dependency-tuple']}


159



160


use the shortcut form of the dependencywarning dependency-tuple build.gradle:

compile group:'junit', name:'junit', version:'+'




161







162







163

dependencies { compile 'org.slf4j:slf4j-api:1.7.21' compile 'junit:junit:latest.release'}

:fixGradleLint

164

dependencies { compile 'org.slf4j:slf4j-api:1.7.21' compile 'junit:junit:latest.release'}

:fixGradleLint

version: 'latest.release'● Много зависимостей● У каждой своя версия● Придумали Bom

165

Альтернативы● Использовать всегда

последнюю версию● не все готовы● отнимает время в самый

неподходящий момент

166

Lock Dependencies● Создали проблему - решили проблему● Lock перед каждым релизом● Апдейт → Тесты → Update Lock

167

compile 'joker.org:demo-lib1: latest.release'...compile 'joker.org:demo-libN: latest.release'

$ ./gradlew generateLock saveLock$ ./gradlew test$ ./gradlew commitLock

168

Lock Dependencies

$ cat dependencies.lock{ "compile": { "com.google.guava:guava": { "locked": "14.0.1", "requested": "14.+" } }, "default": { "com.google.guava:guava": { "locked": "14.0.1", "requested": "14.+" } }, "runtime": { "com.google.guava:guava": { "locked": "14.0.1", ...

169

Lock Dependencies

Release больших кусков● Релиз менеджмент платформы● Много зависимостей● Инструмент для контроля

170

● Релиз менеджмент платформы● Много зависимостей● Инструмент для контроля (не для зергов)

171

Release больших кусков

Dependency Controlapply plugin: 'nebula.dependency-recommender'

dependencyRecommendations { mavenBom module: 'netflix:platform: latest.release' propertiesFile uri: ' http://yourorg/extlib-bundle.properties ', name: 'prop'}

dependencyRecommendations { map recommendations: [ 'commons-logging:commons-logging': '1.1']}

dependencies { compile 'commons-logging:commons-logging' // version 1.1 is selected}

172

http://yourorg/extlib-bundle.properties

dependencyRecommendations { mavenBom module: 'netflix:platform: latest.release' propertiesFile uri: ' http://yourorg/extlib-bundle.properties ', name: 'prop'}

dependencyRecommendations { map recommendations: [' commons-logging:commons-logging': '1.1']}

dependencies { compile 'commons-logging:commons-logging:1.0' // version 1.0 is selected}

173

Dependency Control

http://yourorg/extlib-bundle.properties

Сила в композиции●Plugin<Project> { void apply(Project project) { project.plugins.apply( GradleLintPlugin)

gradleLint.rules = ['dependency-parentheses' , 'dependency-tuple'

]

project.plugins.apply( JavadocJarPlugin) project.plugins.apply( SourceJarPlugin) project.plugins.apply( DependencyLockPlugin) project.tasks.withType(Test) { Test testTask -> testTask.testLogging.exceptionFormat = 'full' } }}

174

Итоги1. Zerg Rush - в нужный момент2. Императивный → Декларативный3. init.gradle + CI = ❤4. C Gradle можно и в enterprise

175

176

Можно ли перестать быть зергом?

GrGit - https://github.com/ajoberstar/grgit

Nebula Release Plugin -

Nebula Lint Plugin - https://github.com/nebula-plugins/gradle-lint-plugin

Nebula Dependency Lock Plugin

Nebula Dependency Recommender Plugin

177

https://github.com/ajoberstar/grgit

https://github.com/nebula-plugins/gradle-lint-plugin

QA

178

QA

182

Нельзя просто так взять и зарелизить

183

Что будет● Source → Binary с помощью Gradle● Подводные камни● Хорошие практики● Поддержка скриптов сборки

184

История проблемы

185


?

186


VCS

187


ConflictsVCS

188


Conflicts

Tools

VCS

189


Conflicts

Tools Delivery

VCS

190

Тяжеловато● Статичные зависимости для Сборки● Как передавать команде все это?● Что если сломался или недоступен

http://ext.ru/awesome.gradle?● Нужен принципиально новый подход● Нужен инструмент для валидации● Самое главное - зависимости

191



192

ДоставляемPR?./gradew build


не PR инет тега

не PR иесть тег


release management -...

Documents