X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/8ad5eb9a8f15ab52cab68911121a87ca0971b175..623b01534a135a964cc473b45cf8333a780a1b74:/doc/_includes/_install_ruby_and_bundler.liquid
diff --git a/doc/_includes/_install_ruby_and_bundler.liquid b/doc/_includes/_install_ruby_and_bundler.liquid
index a8323f592d..5d5bc9e9d7 100644
--- a/doc/_includes/_install_ruby_and_bundler.liquid
+++ b/doc/_includes/_install_ruby_and_bundler.liquid
@@ -4,66 +4,81 @@ Copyright (C) The Arvados Authors. All rights reserved.
SPDX-License-Identifier: CC-BY-SA-3.0
{% endcomment %}
-Ruby 2.5 is recommended; Ruby 2.3 is also known to work.
+Ruby 2.7 or newer is required.
-h4(#rvm). *Option 1: Install with RVM*
+* "Option 1: Install from packages":#packages
+* "Option 2: Install with RVM":#rvm
-sudo gpg --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
-\curl -sSL https://get.rvm.io | sudo bash -s stable --ruby=2.5
-
source /usr/local/rvm/scripts/rvm
-
~$ gem install bundler
-
# dnf module enable ruby:2.7
+# dnf install --enablerepo=devel ruby ruby-devel
+
+
+h3. Debian and Ubuntu
-h4(#fromsource). *Option 2: Install from source*
+Debian 10 (buster) and Ubuntu 18.04 (bionic) ship with Ruby 2.5, which is too old for Arvados. Use "RVM":#rvm to install Ruby 2.7 or newer.
-Install prerequisites for Debian 8:
+Debian 11 (bullseye) and Ubuntu 20.04 (focal) and later ship with Ruby 2.7 or newer, which is sufficient for Arvados.
sudo apt-get install \
- bison build-essential gettext libcurl3 libcurl3-gnutls \
- libcurl4-openssl-dev libpcre3-dev libreadline-dev \
- libssl-dev libxslt1.1 zlib1g-dev
-
# apt-get --no-install-recommends install ruby ruby-dev
+
+
+h2(#rvm). Option 2: Install with RVM
+
+{% include 'notebox_begin_warning' %}
+We do not recommend using RVM unless the Ruby version provided by your OS distribution is older than 2.7.
+{% include 'notebox_end' %}
+
+h3. Install gpg and curl
+
+h4. CentOS/Red Hat 7
-Install prerequisites for CentOS 7:
++yum install gpg curl which findutils procps ++ +{% comment %} +To build ruby 3.2.2 on CentOS 7, add: "yum --enablerepo=powertools install libyaml-devel" +{% endcomment %} + +h4. Alma/CentOS/Red Hat/Rocky 8+ + +
+dnf install gpg curl which findutils procps ++ +h4. Debian and Ubuntu + +
+apt-get --no-install-recommends install gpg curl ca-certificates dirmngr procps ++ +h3. Install RVM, Ruby and Bundler
sudo yum install \
- libyaml-devel glibc-headers autoconf gcc-c++ glibc-devel \
- patch readline-devel zlib-devel libffi-devel openssl-devel \
- make automake libtool bison sqlite-devel tar
+gpg --keyserver pgp.mit.edu --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
+\curl -sSL https://get.rvm.io | bash -s stable --ruby=2.7.7
sudo apt-get install \
- gawk g++ gcc make libc6-dev libreadline6-dev zlib1g-dev libssl-dev \
- libyaml-dev libsqlite3-dev sqlite3 autoconf libgdbm-dev \
- libncurses5-dev automake libtool bison pkg-config libffi-dev curl
+source /usr/local/rvm/scripts/rvm
mkdir -p ~/src
-cd ~/src
-curl -f http://cache.ruby-lang.org/pub/ruby/2.5/ruby-2.5.5.tar.gz | tar xz
-cd ruby-2.5.5
-./configure --disable-install-rdoc
-make
-sudo make install
-
-sudo -i gem install bundler
-
rvm-exec default ruby -v
+