1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-06 15:46:57 +01:00
Files
openshift-docs/cli_reference/openshift_developer_cli/understanding-odo.adoc
Yana Hontyk 59bf4a466d Added Core concepts heading to Understanding odo
Conflicts:
	cli_reference/openshift_developer_cli/understanding-odo.adoc
2019-12-17 10:05:31 -05:00

87 lines
4.0 KiB
Plaintext

[id="understanding-odo"]
= Understanding OpenShift Do
include::modules/openshift-developer-cli-attributes.adoc[]
include::modules/common-attributes.adoc[]
:context: understanding-odo
toc::[]
{odo-title-full} ({odo-title}) is a fast and easy-to-use CLI tool for creating applications on {product-title}. {odo-title} allows developers to concentrate on creating applications without the need to administrate an {product-title} cluster itself.
Creating deployment configurations, build configurations, service routes and other {product-title} elements are all automated by {odo-title}.
Existing tools such as `oc` are more operations-focused and require a deep understanding of Kubernetes and {product-title} concepts. {odo-title} abstracts away complex Kubernetes and {product-title} concepts allowing developers to focus on what is most important to them: code.
[id="odo-key-features"]
== Key features
{odo-title} is designed to be simple and concise with the following key features:
* Simple syntax and design centered around concepts familiar to developers, such as projects, applications, and components.
* Completely client based. No server is required within the {product-title} cluster for deployment.
* Official support for Node.js and Java components.
* Partial compatibility with languages and frameworks such as Ruby, Perl, PHP, and Python.
* Detects changes to local code and deploys it to the cluster automatically, giving instant feedback to validate changes in real time.
* Lists all the available components and services from the {product-title} cluster.
== Core concepts
Project::
A project is your source code, tests, and libraries organized in a separate single unit.
Application::
An application is a program designed for end users. An application consists of multiple microservices or components that work individually to build the entire application.
Examples of applications: a video game, a media player, a web browser.
Component::
A component is a building block of an application. Typically it is a software package, a web service, a web resource, or a module that encapsulates a set of related functions or data.
Examples of components: Node.js, Pearl, PHP, Python, Ruby.
Service::
A service is software that your component links to or depends on.
Examples of services: MariaDB, Jenkins, MySQL.
In {odo-title}, services are provisioned from the OpenShift Service Catalog and must be enabled within your cluster.
[id="odo-supported-languages-and-images"]
=== Officially supported languages and corresponding container images
.Supported container images
[options="header"]
|====
|Node.js|Java
|`centos/nodejs-8-centos7`|`redhat-openjdk-18/openjdk18-openshift`
|`rhoar-nodejs/nodejs-8`|`openjdk/openjdk-11-rhel8`
|`rhoar-nodejs/nodejs-10`|`openjdk/openjdk-11-rhel7`
|`bucharestgold/centos7-s2i-nodejs`|
|`rhscl/nodejs-8-rhel7`|
|`rhscl/nodejs-10-rhel7`|
|====
[id="odo-listing-available-images"]
==== Listing available container images
[NOTE]
====
The list of available container images is sourced from the cluster's internal container registry and external registries associated with the cluster.
====
To list the available components and associated container images for your cluster:
. Log in to the {product-title} cluster with {odo-title}:
+
----
$ odo login -u developer -p developer
----
. List the available {odo-title} supported and unsupported components and corresponding container images:
+
----------------------------------------------------
$ odo catalog list components
Odo Supported OpenShift Components:
NAME PROJECT TAGS
java openshift 8,latest
nodejs openshift 10,8,8-RHOAR,latest
Odo Unsupported OpenShift Components:
NAME PROJECT TAGS
dotnet openshift 1.0,1.1,2.1,2.2,latest
fuse7-eap-openshift openshift 1.3
----------------------------------------------------
+
The `TAGS` column represents the available image versions, for example, `10` represents the `rhoar-nodejs/nodejs-10` container image.