Skip to content

Commit 52b975d

Browse files
authored
Update installation.md
1 parent b909a4e commit 52b975d

1 file changed

Lines changed: 22 additions & 17 deletions

File tree

  • content/learning-paths/servers-and-cloud-computing/ruby-on-rails

content/learning-paths/servers-and-cloud-computing/ruby-on-rails/installation.md

Lines changed: 22 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -7,52 +7,50 @@ layout: learningpathall
77
---
88

99
## Install Ruby on Rails
10-
In this section, you will learn how to install Ruby, Rails, and related tools (like rbenv and Bundler) on a SUSE Arm-based virtual machine. This guide will also cover installing the necessary dependencies to compile Ruby and run Rails applications smoothly.
11-
10+
In this section, you’ll install Ruby, Rails, and essential supporting tools on a SUSE Arm64 your Google Cloud C4A instance running SUSE Enterprise Linux. The steps ensure your environment is ready to build, deploy, and optimize Ruby on Rails applications on Arm-based infrastructure.
1211

1312
### Update System Packages
14-
Updates all system packages to the latest versions to ensure stability and security.
13+
Before installation, update all existing system packages. This ensures you have the latest security patches, compiler toolchains, and library versions compatible with Ruby.
1514

1615
```console
1716
sudo zypper update
1817
```
1918

2019
### Install Required Dependencies
21-
These packages are essential for compiling Ruby and its native extensions.
20+
Before installing Ruby, you need to install several core development libraries and tools. These packages ensure that Ruby and its native extensions compile and run correctly on your SUSE Arm64 environment.
2221

2322
```console
2423
sudo zypper install git curl gcc make patch libyaml-devel libffi-devel libopenssl-devel readline-devel zlib-devel gdbm-devel bzip2 bzip2-devel
2524
```
2625

2726
### Install rbenv
28-
**rbenv** is a lightweight Ruby version manager that allows multiple Ruby versions on the same system.
27+
`rbenv` is a lightweight Ruby version manager that enables you to install and manage multiple Ruby versions on the same system. This is particularly useful for developers running different Rails applications that require specific Ruby versions.
2928

3029
```console
3130
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
3231
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
3332
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
3433
source ~/.bashrc
3534
```
36-
- Clones the rbenv repository to manage Ruby versions
37-
- Updates `PATH` so your shell can find rbenv
38-
- Initializes rbenv in your shell session
35+
With these steps you have cloned the `rbenv` repository to manage Ruby versions. Your `PATH` is updated so your shell can find rbenv. It then initializes rbenv in your shell session.
3936

4037
### Install ruby-build Plugin
41-
**ruby-build** is an rbenv plugin that provides the `rbenv install` command to compile and install different Ruby versions from source.
38+
`ruby-build` is an rbenv plugin that adds the `rbenv` install command, allowing you to compile and install specific Ruby versions from source.
4239

4340
```console
4441
git clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build
4542
```
4643

4744
### Install Ruby
48-
Installs Ruby and sets it as the default version for your environment.
45+
Now that `rbenv` and `ruby-build` are set up, you can install Ruby and configure it as your system’s default version. This step compiles Ruby from source:
4946

5047
```console
5148
rbenv install 3.4.6
5249
rbenv global 3.4.6
5350
ruby -v
5451
```
55-
- Installs Ruby 3.4.6 from source
52+
With these commands you have:
53+
- Installed Ruby 3.4.6 from source
5654
- Sets it as the default Ruby version for your user
5755
- `ruby -v` verifies the installed Ruby version
5856

@@ -61,29 +59,36 @@ You should see output similar to:
6159
ruby 3.4.6 (2025-09-16 revision dbd83256b1) +PRISM [aarch64-linux]
6260
```
6361
{{% notice Note %}}
64-
Ruby 3.4.0 introduced significant performance enhancements, notably improvements to YJIT (Yet Another Ruby JIT), a Ruby just-in-time compiler. These enhancements are particularly beneficial for Arm architectures, as YJIT has been optimized to deliver better performance on such platforms. To leverage these improvements, it is recommended that you upgrade to Ruby 3.4.0 or later.
62+
Ruby 3.4.0 and later introduced major performance enhancements, especially in YJIT (Yet Another Ruby JIT), Ruby’s Just-In-Time compiler. These enhancements are particularly beneficial for Arm architectures, as YJIT has been optimized to deliver better performance on such platforms. To leverage these improvements, it is recommended that you upgrade to Ruby 3.4.0 or later.
6563
You can view [this release note](https://www.ruby-lang.org/en/news/2024/12/25/ruby-3-4-0-released/)
6664

6765
The [Arm Ecosystem Dashboard](https://developer.arm.com/ecosystem-dashboard/) recommends Ruby version 3.4.0, the minimum recommended on the Arm platforms.
6866
{{% /notice %}}
6967

7068
### Install Bundler
71-
**Bundler** manages Ruby project dependencies and ensures consistent gem versions across environments.
69+
Bundler is Ruby’s dependency management tool. It ensures that all required gems (libraries) for your Rails application are installed and consistent across development, test, and production environments.
70+
71+
Install Bundler globally:
7272

7373
```console
7474
gem install bundler
7575
```
76+
This command installs Bundler for the active Ruby version managed by rbenv.
7677

7778
### Install Rails
78-
Rails is a full-stack web application framework for Ruby that simplifies building database-backed web applications with convention over configuration.
79+
Rails is a full-stack web framework built in Ruby, designed for rapid development using convention over configuration principles.
80+
Installing Rails on your SUSE Arm64 VM enables you to build and deploy web applications natively on Google Cloud Axion (C4A) processors.
7981

8082
```console
8183
gem install rails
82-
rails -v
8384
```
84-
- Installs the Rails framework
85-
- `rails -v` verifies the installed Rails version
8685

86+
### Verify Rails version
87+
Confirms that Rails is installed and accessible from your environment:
88+
89+
```console
90+
rails -v
91+
```
8792
You should see output similar to:
8893
```output
8994
Rails 8.0.3

0 commit comments

Comments
 (0)