Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Boxiang Sun
gitlab-ce
Commits
dd0223f5
Commit
dd0223f5
authored
Dec 06, 2017
by
Rémy Coutable
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Address Robert's and Axil's feedback
Signed-off-by:
Rémy Coutable
<
remy@rymai.me
>
parent
aaf16997
Changes
4
Hide whitespace changes
Inline
Side-by-side
Showing
4 changed files
with
17 additions
and
15 deletions
+17
-15
PROCESS.md
PROCESS.md
+1
-1
doc/development/automatic_ce_ee_merge.md
doc/development/automatic_ce_ee_merge.md
+14
-12
doc/development/ee_features.md
doc/development/ee_features.md
+1
-1
doc/development/writing_documentation.md
doc/development/writing_documentation.md
+1
-1
No files found.
PROCESS.md
View file @
dd0223f5
...
@@ -131,7 +131,7 @@ request, even if there are no conflicts. This is to reduce the size of the
...
@@ -131,7 +131,7 @@ request, even if there are no conflicts. This is to reduce the size of the
subsequent EE merge, as we often merge a lot to CE on the release date. For more
subsequent EE merge, as we often merge a lot to CE on the release date. For more
information, see
information, see
[
Automatic CE->EE merge
][
automatic_ce_ee_merge
]
and
[
Automatic CE->EE merge
][
automatic_ce_ee_merge
]
and
[
Guidelines for implementing Enterprise Edition feature
][
ee_features
]
.
[
Guidelines for implementing Enterprise Edition feature
s
][
ee_features
]
.
### After the 7th
### After the 7th
...
...
doc/development/automatic_ce_ee_merge.md
View file @
dd0223f5
...
@@ -5,7 +5,6 @@ Enterprise Edition (look for the [`CE Upstream` merge requests]).
...
@@ -5,7 +5,6 @@ Enterprise Edition (look for the [`CE Upstream` merge requests]).
This merge is done automatically in a
This merge is done automatically in a
[
scheduled pipeline
](
https://gitlab.com/gitlab-org/release-tools/-/jobs/43201679
)
.
[
scheduled pipeline
](
https://gitlab.com/gitlab-org/release-tools/-/jobs/43201679
)
.
If a merge is already in progress, the job
[
doesn't create a new one
](
https://gitlab.com/gitlab-org/release-tools/-/jobs/43157687
)
.
If a merge is already in progress, the job
[
doesn't create a new one
](
https://gitlab.com/gitlab-org/release-tools/-/jobs/43157687
)
.
**
If you are pinged in a
`CE Upstream`
merge request to resolve a conflict,
**
If you are pinged in a
`CE Upstream`
merge request to resolve a conflict,
...
@@ -16,10 +15,12 @@ It's ok to resolve more conflicts than the one that you are asked to resolve. In
...
@@ -16,10 +15,12 @@ It's ok to resolve more conflicts than the one that you are asked to resolve. In
that case, it's a good habit to ask for a double-check on your resolution by
that case, it's a good habit to ask for a double-check on your resolution by
someone who is familiar with the code you touched.
someone who is familiar with the code you touched.
### Always merge EE merge request before their CE counterpart
[
`CE Upstream` merge requests
]:
https://gitlab.com/gitlab-org/gitlab-ee/merge_requests?label_name%5B%5D=CE+upstream
### Always merge EE merge requests before their CE counterparts
**
In order to avoid conflicts in the CE->EE merge, you should always merge the
**
In order to avoid conflicts in the CE->EE merge, you should always merge the
EE version of your CE merge request
(if present)
.
**
EE version of your CE merge request
first, if present
.
**
The rationale for this is that as CE->EE merges are done automatically every few
The rationale for this is that as CE->EE merges are done automatically every few
hours, it can happen that:
hours, it can happen that:
...
@@ -30,26 +31,27 @@ hours, it can happen that:
...
@@ -30,26 +31,27 @@ hours, it can happen that:
merged yet
merged yet
1.
The automatic merge bot will ping someone to resolve the conflict
**
that are
1.
The automatic merge bot will ping someone to resolve the conflict
**
that are
already resolved in the EE merge request that isn't merged yet
**
already resolved in the EE merge request that isn't merged yet
**
1.
That's a waste of time, and that's why you should merge EE merge request
before their CE counterpart
That's a waste of time, and that's why you should merge EE merge request before
their CE counterpart.
## Avoiding CE->EE merge conflicts beforehand
## Avoiding CE->EE merge conflicts beforehand
To avoid the conflicts beforehand, check out the
To avoid the conflicts beforehand, check out the
[
Guidelines for implementing Enterprise Edition feature
](
ee_features.md
)
.
[
Guidelines for implementing Enterprise Edition feature
s
](
ee_features.md
)
.
In any case, the CI
`ee_compat_check`
job will tell you if you need to open an
In any case, the CI
`ee_compat_check`
job will tell you if you need to open an
EE version of your CE merge request.
EE version of your CE merge request.
### Conflicts detection in CE merge requests
### Conflicts detection in CE merge requests
For each commit (except on
`master`
), the
`
rake
ee_compat_check`
CI job tries to
For each commit (except on
`master`
), the
`ee_compat_check`
CI job tries to
detect if the current branch's changes will conflict during the CE->EE merge.
detect if the current branch's changes will conflict during the CE->EE merge.
The job reports what files are conflicting and how to setup a merge request
The job reports what files are conflicting and how to setup a merge request
against EE.
against EE.
#### How the job works
?
#### How the job works
1.
Generates the diff between your branch and current CE
`master`
1.
Generates the diff between your branch and current CE
`master`
1.
Tries to apply it to current EE
`master`
1.
Tries to apply it to current EE
`master`
...
@@ -69,9 +71,9 @@ Notes:
...
@@ -69,9 +71,9 @@ Notes:
-
This task is not a silver-bullet, its current goal is to bring awareness to
-
This task is not a silver-bullet, its current goal is to bring awareness to
developers that their work needs to be ported to EE.
developers that their work needs to be ported to EE.
-
Community contributors shouldn't
submit merge requests against EE, bu
t
-
Community contributors shouldn't
be required to submit merge requests agains
t
reviewers should take actions by either creating such EE merge request or
EE, but reviewers should take actions by either creating such EE merge request
asking a GitLab developer to do it
**before the merge request is merged**
.
or
asking a GitLab developer to do it
**before the merge request is merged**
.
-
If you branch is too far behind
`master`
, the job will fail. In that case you
-
If you branch is too far behind
`master`
, the job will fail. In that case you
should rebase your branch upon latest
`master`
.
should rebase your branch upon latest
`master`
.
-
Code reviews for merge requests often consist of multiple iterations of
-
Code reviews for merge requests often consist of multiple iterations of
...
@@ -82,7 +84,7 @@ Notes:
...
@@ -82,7 +84,7 @@ Notes:
This helps to identify significant conflicts sooner, but also reduces the
This helps to identify significant conflicts sooner, but also reduces the
number of times you have to resolve conflicts.
number of times you have to resolve conflicts.
-
Please remember to
-
Please remember to
[
always have you
EE merge request merged before the CE one
](
#always-merge-ee-merge-request-before-their-ce-counterpart
)
.
[
always have you
r EE merge request merged before the CE version
](
#always-merge-ee-merge-requests-before-their-ce-counterparts
)
.
-
You can use
[
`git rerere`
](
https://git-scm.com/blog/2010/03/08/rerere.html
)
-
You can use
[
`git rerere`
](
https://git-scm.com/blog/2010/03/08/rerere.html
)
to avoid resolving the same conflicts multiple times.
to avoid resolving the same conflicts multiple times.
...
...
doc/development/ee_features.md
View file @
dd0223f5
# Guidelines for implementing Enterprise Edition feature
# Guidelines for implementing Enterprise Edition feature
s
-
**Write the code and the tests.**
: As with any code, EE features should have
-
**Write the code and the tests.**
: As with any code, EE features should have
good test coverage to prevent regressions.
good test coverage to prevent regressions.
...
...
doc/development/writing_documentation.md
View file @
dd0223f5
...
@@ -142,7 +142,7 @@ tests. If it doesn't, the whole test suite will run (including docs).
...
@@ -142,7 +142,7 @@ tests. If it doesn't, the whole test suite will run (including docs).
---
---
When you submit a merge request to GitLab Community Edition (CE), there is an
When you submit a merge request to GitLab Community Edition (CE), there is an
additional job called
`
rake
ee_compat_check`
that runs against Enterprise
additional job called
`ee_compat_check`
that runs against Enterprise
Edition (EE) and checks if your changes can apply cleanly to the EE codebase.
Edition (EE) and checks if your changes can apply cleanly to the EE codebase.
If that job fails, read the instructions in the job log for what to do next.
If that job fails, read the instructions in the job log for what to do next.
Contributors do not need to submit their changes to EE, GitLab Inc. employees
Contributors do not need to submit their changes to EE, GitLab Inc. employees
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment