2020-10-30 14:08:56 -04:00
---
stage: none
group: unassigned
2020-11-26 01:09:20 -05:00
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2020-10-30 14:08:56 -04:00
---
2017-01-27 06:17:21 -05:00
# `Gemfile` guidelines
When adding a new entry to `Gemfile` or upgrading an existing dependency pay
attention to the following rules.
2019-08-27 04:44:07 -04:00
## No gems fetched from Git repositories
2017-01-27 06:17:21 -05:00
2019-08-27 04:44:07 -04:00
We do not allow gems that are fetched from Git repositories. All gems have
2017-01-27 06:17:21 -05:00
to be available in the RubyGems index. We want to minimize external build
dependencies and build times.
## License compliance
Refer to [licensing guidelines ](licensing.md ) for ensuring license compliance.
2021-01-19 13:11:04 -05:00
## Upgrade Rails
When upgrading the Rails gem and its dependencies, you also should update the following:
2021-02-03 16:09:17 -05:00
- The [`Gemfile` in the `qa` directory ](https://gitlab.com/gitlab-org/gitlab/-/blob/master/qa/Gemfile ).
- The [`Gemfile` in Gitaly Ruby ](https://gitlab.com/gitlab-org/gitaly/-/blob/master/ruby/Gemfile ),
2021-01-19 13:11:04 -05:00
to ensure that we ship only one version of these gems.
2021-02-12 22:08:45 -05:00
You should also update npm packages that follow the current version of Rails:
2021-01-19 13:11:04 -05:00
- `@rails/ujs`
- `@rails/actioncable`