Sign Up
Log In
Log In
or
Sign Up
Places
All Projects
Status Monitor
Collapse sidebar
home:defolos:BCI:Staging:SLE-15-SP6:6-1443
sac-apache-tomcat-10-java21-image
README.md
Overview
Repositories
Revisions
Requests
Users
Attributes
Meta
File README.md of Package sac-apache-tomcat-10-java21-image
# Tomcat 10-jre21 container image ![Support Level](https://img.shields.io/badge/Support_Level-techpreview-blue) [![SLSA](https://img.shields.io/badge/SLSA_(v0.1)-Level_4-Green)](https://documentation.suse.com/sbp/server-linux/html/SBP-SLSA4/) [![Provenance: Available](https://img.shields.io/badge/Provenance-Available-Green)](https://documentation.suse.com/container/all/html/Container-guide/index.html#container-verify) ## Description Apache Tomcat (Tomcat for short) is a free and open-source implementation of the Jakarta Servlet, Jakarta Expression Language, and WebSocket technologies. It provides a pure Java HTTP web server environment that can run Java code. It is a Java web application server and not a complete JEE application server. ## Usage By default, the image launches Tomcat with the same configuration as the one that comes with SUSE Linux Enterprise Server. The difference is that logging is sent to stdout, meaning that the `podman logs tomcat` command displays Tomcat logs. For security reasons, the image runs as the **tomcat** user. This means that additional packages cannot be installed via `zypper`, unless the user becomes `root`. To deploy an application, copy the `.war` file into `$CATALINA_BASE/webapps` (either during a container build or by bind-mounting the directory), and launch the container using the following command: ```ShellSession $ podman run -d --rm -p 8080:8080 dp.apps.rancher.io/suse/apache-tomcat:10-jre21 ``` The deployed webapp is then accessible via `http://localhost:8080/$webapp_name`. ### How to use the image with rootless Podman The container image can be used in rootless mode with Podman. Keep in mind that Podman remaps the `tomcat` user in the container to a different user on the host. This user does not have write access to the mounted directory. To avoid permission issues change permissions of the shared directory to `0777` as follows: ```ShellSession $ chmod 0777 /path/to/my/app $ podman run --rm -d -v /path/to/my/app:/usr/share/tomcat/webapps:z \ -p 8080:8080 dp.apps.rancher.io/suse/apache-tomcat:10-jre21 ``` ## Configuration The main Tomcat configuration files (for example `/etc/tomcat/logging.properties`) are stored in `/etc/tomcat/`. Tomcat's runtime options can be configured using the environment variables `JAVA_OPTS` and `CATALINA_OPTS`. `JAVA_OPTS` specifies general options used for the JVM, whereas `CATALINA_OPTS` specifies Tomcat's flags. You can pass the options to the container runtime using the `-e` flag: ```ShellSession $ podman run -it --rm \ -e JAVA_OPTS="-Xmx1024m" -p 8080:8080 \ dp.apps.rancher.io/suse/apache-tomcat:10-jre21 ``` The image ships with `CATALINA_HOME` set to `/usr/share/tomcat` and `CATALINA_BASE` set to `/usr/share/tomcat`. ## Samples By default, the sample applications shipped with Tomcat are not installed in the container image. Add them by installing one of the following packages: - tomcat10-webapps - tomcat10-admin-webapps ## Upgrading from Tomcat 9 Tomcat 9 implements Java EE 8, and Tomcat 10 implements Jakarta EE 9. Before upgrading from version 9, consult the [upstream migration guide](https://tomcat.apache.org/migration-10.html). ## Licensing `SPDX-License-Identifier: MIT` This documentation and the build recipe are licensed as MIT. The container itself contains various software components under various open source licenses listed in the associated Software Bill of Materials (SBOM). This image is a tech preview. Do not use it for production. Your feedback is welcome. Please report any issues to the [SUSE Bugzilla](https://bugzilla.suse.com/enter_bug.cgi?product=SUSE%20Linux%20Enterprise%20Base%20Container%20Images).
Locations
Projects
Search
Status Monitor
Help
OpenBuildService.org
Documentation
API Documentation
Code of Conduct
Contact
Support
@OBShq
Terms
openSUSE Build Service is sponsored by
The Open Build Service is an
openSUSE project
.
Sign Up
Log In
Places
Places
All Projects
Status Monitor