Skip to content

Commit 4ad2344

Browse files
Merge pull request #3462 from travis-ci/km-TDOC-324
Update Ubuntu bionic, focal and jammy Build Environment docs
2 parents 9b9c61e + e7182a7 commit 4ad2344

File tree

3 files changed

+254
-410
lines changed

3 files changed

+254
-410
lines changed

user/reference/bionic.md

Lines changed: 100 additions & 182 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ layout: en
77
88
## What This Guide Covers
99

10-
This guide provides an overview of the packages, tools and settings available in the Bionic environment.
10+
This guide provides an overview of the packages, tools, and settings available in the Bionic environment.
1111

1212
## Using Ubuntu 18.04 (Bionic Beaver)
1313

@@ -18,224 +18,142 @@ dist: bionic
1818
```
1919
{: data-file=".travis.yml"}
2020
21+
## Environment Common to All Ubuntu 18.04 Images
2122
22-
## Differences from the previous release images
23+
All Ubuntu 18.04 builds include the following versions of Docker: version control software, compilers, and language support. All preinstalled software not provided by the distro is installed from an official release—either a prebuilt binary, if available, or a source release built with default options.
2324
24-
Travis CI Ubuntu 18.04, Bionic, includes the following changes and improvements:
25+
### Version Control
2526
26-
### Third party apt-repositories removed
27-
28-
While third party apt-repositories are used during the image provisioning, they are all removed from the Bionic build image. This has two benefits; a) reduced risk of unrelated interference and b) faster apt-get updates.
29-
30-
To specify a third party apt-repository, you can [add the source with the apt addon](/user/installing-dependencies/#adding-apt-sources) and specify the packages. For example:
31-
32-
```yaml
33-
dist: bionic
34-
addons:
35-
apt:
36-
sources:
37-
- ppa:chris-lea/redis-server
38-
packages:
39-
- redis-tools
40-
- redis-server
41-
```
42-
{: data-file=".travis.yml"}
43-
44-
If you depend on these repositories in your build, you can use the following `source` line to get them back:
45-
46-
| package | source |
47-
|:---------------------|:-----------------------------|
48-
| couchdb | `https://couchdb.apache.org/repo/` |
49-
| docker | `docker` |
50-
| google-chrome-stable | `google-chrome` |
51-
| git-lfs | `github-git-lfs-bionic` |
52-
| git-ppa | `ppa:git-core/ppa` |
53-
| haskell | `ppa:hvr/ghc` |
54-
| mongodb | `mongodb-4.4-bionic` |
55-
| pollinate | `ppa:pollinate/ppa` |
56-
{: style="width: 80%" }
57-
58-
### Services disabled by default
59-
60-
On the Ubuntu 18.04 based environment, to speed up boot time and improve performance we've disabled all services by default.
61-
Add any services that you want to start to your `.travis.yml`:
62-
63-
64-
```yaml
65-
services:
66-
- mysql
67-
- redis
68-
```
69-
{: data-file=".travis.yml"}
70-
71-
## Environment common to all Ubuntu 18.04 images
72-
73-
The following versions of Docker, version control software and compilers are present on all Ubuntu 18.04 builds, along with more language specific software described in more detail in each language section.
74-
75-
All preinstalled software not provided by distro is installed from an official release --
76-
either a prebuilt binary if available, or a source release built with default options.
77-
For preinstalled language interpreters, a standard version manager like `rvm` is used if available for the language.
78-
79-
### Version control
80-
81-
| package | version |
82-
|:--------|:---------|
83-
| git | `2.43.0` |
84-
| git-lfs | `2.3.4` |
85-
| hg | `5.3` |
86-
| svn | `1.9.7` |
27+
| Package | Version |
28+
|:-------------|:----------|
29+
| **git** | `2.43.0` |
30+
| **git-lfs** | `2.3.4` |
31+
| **hg** | `5.3` |
32+
| **svn** | `1.9.7` |
8733
{: style="width: 30%" }
8834

89-
### Compilers and Build toolchain
35+
### Compilers and Build Toolchain
9036

91-
* clang and llvm 16
92-
* cmake 3.26.3
93-
* gcc 7.5.0
94-
* ccache 3.4.1
95-
* shellcheck 0.10.0
96-
* shfmt 3.8.0
97-
98-
To use the IBM Advance Toolchain v14 compilers under `ppc64le` architecture in Focal LXD image, use the following paths in your `.travis.yml`:
99-
100-
- GCC compiler
101-
- Path: `/opt/at14.0/bin/gcc`
102-
- Command: `/opt/at14.0/bin/gcc hello_world.c -o hello_world`
103-
104-
- g++ compiler
105-
- Path: `/opt/at14.0/bin/g++`
106-
- Command: `/opt/at14.0/bin/g++ hello_world.cpp -o hello_world`
37+
| Tool | Version |
38+
|:---------------|:-----------|
39+
| **clang** | `18.1.8` |
40+
| **cmake** | `3.26.3` |
41+
| **gcc** | `7.5.0` |
42+
| **ccache** | `3.4.1` |
43+
| **ShellCheck** | `0.10.0` |
44+
| **shfmt** | `3.8.0` |
45+
{: style="width: 30%" }
10746

108-
- Go compiler
109-
- Path: `/opt/at14.0/bin/gccgo`
110-
- Command: `/opt/at14.0/bin/gccgo hello_world.go -o hello_world`
47+
### Docker
11148

112-
- Python
113-
- First, compile Python 3.8.0 using the `python_interpreter.sh script`.
114-
- Python Interpreter Path: `/opt/python380-at14/python3.8`
115-
- Build Python Command: `sudo sh python_interpreter.sh`
49+
| Package | Version |
50+
|:-------------------|:----------------------------------|
51+
| **Docker** | `24.0.2` (build cb74dfc) |
52+
| **docker-compose** | `v2.20.3` |
53+
{: style="width: 30%" }
11654

117-
To use the IBM Advance Toolchain v14 compilers under `amd64` architecture in Focal LXD image, use the following paths in your `.travis.yml`:
55+
### Ruby Support
11856

119-
- GCC compiler
120-
- Path: `/opt/at14.0/bin/powerpc64le-linux-gnu-gcc`
121-
- Command: `/opt/at14.0/bin/powerpc64le-linux-gnu-gcc hello_world.c -o hello_world`
57+
* **Pre-installed Ruby**:
58+
* `ruby 3.3.5`
59+
* Other Ruby versions (e.g., 2.7.x, 3.1.x) can be installed during build time.
12260

123-
- g++ compiler
124-
- Path: `/opt/at14.0/bin/powerpc64le-linux-gnu-g++`
125-
Command: `/opt/at14.0/bin/powerpc64le-linux-gnu-g++ hello_world.cpp -o hello_world`
61+
### Python Support
12662

127-
- Go compiler
128-
- Path: `/opt/at14.0/bin/powerpc64le-linux-gnu-gccgo`
129-
- Command: `/opt/at14.0/bin/powerpc64le-linux-gnu-gccgo hello_world.go -o hello_world`
63+
* **Supported Python versions:** 3.6 or higher.
13064

131-
- Python
132-
- First, compile Python 3.8.0 using the `python_interpreter.sh script`.
133-
- Python Interpreter Path: `/opt/python380-amd64/python3.8`
134-
- Build Python Command: `sudo sh python_interpreter.sh`
65+
The following Python versions are directly callable:
13566

136-
### Docker
67+
| Alias | Version |
68+
|:---------|:----------|
69+
| **3.6** | `3.6.9` |
70+
| **3.7** | `3.7.17` |
71+
| **3.8** | `3.8.18` |
72+
| **3.12** | `3.12.4` |
73+
74+
### JavaScript and Node.js Support
13775

138-
* Docker 24.0.2 is installed
139-
* docker-compose 2.18.1
76+
* For builds specifying `language: node_js`, `nvm` is automatically updated to the latest version at build time.
77+
* The default Node.js version available on the machine is:
78+
* `v16.15.1`
79+
* Additional Node.js versions are available through nvm if configured.
14080

141-
## Ruby support
81+
### Go Support
14282

143-
* Pre-installed Rubies: `2.5.9`, `2.7.6` and `3.3.0`.
144-
* The default ruby is `3.3.0`.
145-
* Other ruby versions can be installed during build time.
83+
* **Pre-installed Go:**
84+
* `go version go1.23.6 linux/amd64`
85+
Additional Go versions can be installed during build time by specifying the language version with the `go:` key.
14686

147-
## Python support
87+
### JVM (Clojure, Groovy, Java, Scala) Support
14888

149-
* Supported Python versions: `3.6` or higher.
150-
* Python `3.12.0` will be used when no language version is explicitly set.
151-
* The following Python versions are preinstalled:
89+
* **Pre-installed JVMs:**
90+
* Default Java:
91+
* `openjdk version "11.0.21" 2023-10-17 LTS`
92+
* Other JDKs, including Oracle's, can be acquired if available by specifying the `jdk` key.
93+
* The following JVM tooling is preinstalled:
15294

153-
| alias | version |
154-
| :----- | :------- |
155-
| 3.6 | 3.6.15 |
156-
| 3.7 | 3.7.17 |
157-
| 3.8 | 3.8.18 |
158-
| 3.12 | 3.12.0 |
95+
| Package | Version |
96+
|:-----------|:----------|
97+
| **Gradle** | `8.3` |
98+
| **Maven** | `3.9.4` |
99+
| **Groovy** | `4.0.15` |
159100
{: style="width: 30%" }
160101

161-
If you're getting errors about PyPy `pypy is not installed; attempting download`, use one of the more recent versions.
162-
163-
## JavaScript and Node.js support
164-
165-
* For builds specifying `language: node_js`, `nvm` is automatically updated to the latest version at build time. For other builds, the stable version at image build time has been selected, which is 0.10.48.
166-
* The following NodeJS versions are preinstalled: `20.14.0`, `18.20.3`, `16.20.2`, `16.15.1`, `16.15`, `12.22.12`, `10.24.1`, `8.17.0`, `6.17.1` and `4.9.1`.
167-
168-
## Go support
102+
### Perl Support
169103

170-
* Pre-installed Go: `1.18.1`
104+
* The default Perl version on Ubuntu 18.04 is provided by the system.
105+
* Additional Perl versions can be installed using the `perl:` key.
106+
* Tools like `TAP::Harness` and `cpanm` are also available.
171107

172-
* Other Go versions can be installed during build time by specifying the language versions with the `go:`-key.
108+
### PHP Support
173109

174-
## JVM (Clojure, Groovy, Java, Scala) support
175-
176-
* Pre-installed JVMs: `openjdk8`, `openjdk9`, `opnejdk10` and `openjdk11` on x86, default
177-
is `openjdk11`.
110+
* For dynamic runtime selection, `phpenv` is available.
111+
* The preinstalled PHP version on this image is:
112+
* `PHP 7.2.27` (CLI)
113+
* If a different version is required, it can be installed during the build.
178114

179-
* Other JDKs, including Oracle's, can be acquired if available by specifying `jdk`.
115+
#### Extensions for PHP 7.2 and Higher
180116

181-
* The following table summarizes the Pre-installed JVM tooling versions:
117+
The following extensions are preinstalled for PHP builds:
182118

183-
| package | version |
184-
|:--------|:--------|
185-
| gradle | 8.3 |
186-
| maven | 3.9.4 |
187-
| groovy | 4.0.15 |
188-
{: style="width: 30%" }
119+
- [apcu.so](http://php.net/apcu)
120+
- [memcached.so](http://php.net/memcached) (Not preinstalled for > PHP8.0)
121+
- [mongodb.so](https://php.net/mongodb)
122+
- [amqp.so](http://php.net/amqp)
123+
- [zmq.so](http://zeromq.org/bindings:php)
124+
- [xdebug.so](http://xdebug.org)
125+
- [redis.so](http://pecl.php.net/package/redis)
189126

190-
## Perl support
127+
> **Note:** With the exception of xdebug, these extensions are not enabled by default.
191128

192-
* Default version on Bionic is `5.33`
193-
* Supported versions `5.32` and `5.33` can be installed by using the `perl:`-key.
194-
* `TAP::Harness` v3.38 and `cpanm` (App::cpanminus) version 1.7044 are also pre-installed.
129+
### Databases and Services
195130

196-
## PHP support
131+
The following services and databases are preinstalled but do not run by default. To use any in your build, add the service to your `.travis.yml`:
197132

198-
* For dynamic runtime selection, `phpenv` is available.
199-
* The following PHP versions are preinstalled:
200-
201-
| alias | version |
202-
| :----- | :------- |
203-
| 7.1 | 7.1.33 |
204-
| 7.2 | 7.2.27 |
205-
| 7.3 | 7.3.14 |
206-
| 7.4 | 7.4.2 |
133+
| Service | Version / Notes |
134+
|:---------------|:------------------------------------------------------------------------|
135+
| **MongoDB** | `v4.4.29` |
136+
| **MySQL** | `5.7.42` |
137+
| **Redis** | `7.2.5` |
138+
| **PostgreSQL** | *`psql` is not installed by default. Install using `apt-get install postgresql-client-common` if needed.* |
207139
{: style="width: 30%" }
208140

209-
### Extensions
210-
211-
#### PHP 7.1 and higher
141+
### Android Support
212142

213-
The following extensions are preinstalled for PHP 7.1 and higher builds:
143+
For Android builds, the environment provides comprehensive support with the following pre-installed components:
214144

215-
- [apcu.so](http://php.net/apcu)
216-
- [memcached.so](http://php.net/memcached) (Not preinstalled for > PHP8.0)
217-
- [mongodb.so](https://php.net/mongodb)
218-
- [amqp.so](http://php.net/amqp)
219-
- [zmq.so](http://zeromq.org/bindings:php)
220-
- [xdebug.so](http://xdebug.org)
221-
- [redis.so](http://pecl.php.net/package/redis)
145+
- **Android SDK Components** – Installed components include:
146+
- `tools`
147+
- `platform-tools`
148+
- `build-tools;30.0.0`
149+
- `platforms;android-30`
150+
- `extras;google;google_play_services`
151+
- `extras;google;m2repository`
152+
- `extras;android;m2repository`
222153

223-
Please note that these extensions are not enabled by default with the exception
224-
of xdebug.
225-
226-
## Databases and services
227-
228-
The following services and databases are preinstalled but but do not run by default.
229-
To use one in your build, add it to the services key in your `travis.yml` :
230-
231-
| service | version |
232-
|:-----------|:---------------|
233-
| mongodb | 4.4.29 |
234-
| mysql | 5.7.42 |
235-
| redis | 7.2.5 |
236-
| postgresql | 9.3 9.4 9.5 9.6 10 11 |
237-
{: style="width: 30%" }
154+
To use Android, specify `language: android` in your `.travis.yml` and refer to the [Android Build Environment Guide](/user/languages/android/) for additional configuration details.
238155

239156
## Other Ubuntu Linux Build Environments
240157

241-
You can have a look at the [Ubuntu Linux overview page](/user/reference/linux/) for the different Ubuntu Linux build environments you can use.
158+
For details on other Ubuntu Linux build environments available on Travis CI, please refer to the [Ubuntu Linux overview page](/user/reference/linux/).
159+
```

0 commit comments

Comments
 (0)