In this section we will explore the different ways by which you can interact with the catalog:
- On default versions
- Listing existing applications
- Obtaining information about an application
- Deploying an application from the catalog
- Uploading an application to the catalog
- Downloading an application
- Removing an application
- Getting catalog summary
- Playground is installed
$ playground login Login success
By default, if no version is specified on any of the catalog commands, the
latest version is assumed.
On of the first operation you may be interested in is to check which applications are available on the catalog. To explore the contents of the catalog use:
$ playground catalog list APPLICATION NAME napptive/aurora-files:latest Aurora Files. Storage platform napptive/drawio:14.3.0 Drawio napptive/jupyter:ubuntu-20.04 Jupyter napptive/mysql:5.7 Mysql napptive/mysql-phpmyadmin:5.7 Mysql-PHPMyAdmin napptive/nginx:1.20.0 NGINX server napptive/rstudio:4.0.4 Rstudio napptive/tensorflow:nightly-jupyter Tensorflow napptive/wordpress-mysql:5.7.0 Wordpress ...
Alternatively, you can limit the listing to a specified namespace with:
$ playground catalog <another_namespace> APPLICATION NAME <another_namespace>/mysql:latest Mysql <another_namespace>/mysql:v0.0.1 Mysql ...
Each application that is published provides metadata information about the application itself, plus an optional
README.md that can clarify how to work with the application once deployed (e.g., which are the default passwords). To obtain information about a given application use:
$ playground catalog info napptive/drawio:14.3.0 APP_ID NAME napptive/drawio:14.3.0 Drawio DESCRIPTION Free online diagrams software README # Draw.io > diagrams.net (formerly draw.io) is free online diagram software. You can use it as a flowchart maker, network diagram software, to create UML online, as an ER diagram tool, to design database schema, to build BPMN online, as a circuit diagram maker, and more. diagrams.net can import .vsdx, Gliffy™ and Lucidchart™ files. ...
Deploying an application from the catalog is a convenient method to start using the playground without writing any code. Once you have identified the target application to be deployed, use:
$ playground catalog deploy napptive/drawio:14.3.0 STATUS INFO SUCCESS application [drawio] deployed CREATED core.oam.dev/v1alpha2, Kind=Component "drawio" created core.oam.dev/v1alpha2, Kind=ApplicationConfiguration "drawio" created
Uploading application is quite simple, just execute:
playground catalog push myuser/appName:v1.0 /path/to/app STATUS INFO SUCCESS myuser/appName:v1.0 added to catalog
NOTE Your application must contain a
metadata.yaml as describe in The application catalog help.
To obtain a copy of the application, use:
$ playground catalog pull napptive/drawio:14.3.0 STATUS INFO SUCCESS application saved on drawio.tgz
To remove an application use:
$ playground catalog remove myuser/appName:v1.0 STATUS INFO SUCCESS myuser/appName:v1.0 removed from catalog
If you want to know how many namespaces, applications and versions are in the catalog, execute:
$ playground catalog summary NAMESPACES APPLICATIONS TAGS 2 10 11