2.8. Using devfiles in odo

Procedure

1. Log in to an OpenShift Container Platform cluster:

   $ odo login -u developer -p developer

2. Create a project:

   $ odo project create myproject

   Example output

    ✓  Project 'myproject' is ready for use
    ✓  New project created and now using project : myproject

Procedure

1. To list available devfile components on your cluster, run:

   $ odo catalog list components

   The output lists the available odo components:

   Odo Devfile Components:
   NAME                 DESCRIPTION                            REGISTRY
   java-maven           Upstream Maven and OpenJDK 11          DefaultDevfileRegistry
   java-openliberty     Open Liberty microservice in Java      DefaultDevfileRegistry
   java-quarkus         Upstream Quarkus with Java+GraalVM     DefaultDevfileRegistry
   java-springboot      Spring Boot® using Java                DefaultDevfileRegistry
   nodejs               Stack with NodeJS 12                   DefaultDevfileRegistry
   
   Odo OpenShift Components:
   NAME        PROJECT       TAGS                                                                           SUPPORTED
   java        openshift     11,8,latest                                                                    YES
   dotnet      openshift     2.1,3.1,latest                                                                 NO
   golang      openshift     1.13.4-ubi7,1.13.4-ubi8,latest                                                 NO
   httpd       openshift     2.4-el7,2.4-el8,latest                                                         NO
   nginx       openshift     1.14-el7,1.14-el8,1.16-el7,1.16-el8,latest                                     NO
   nodejs      openshift     10-ubi7,10-ubi8,12-ubi7,12-ubi8,latest                                         NO
   perl        openshift     5.26-el7,5.26-ubi8,5.30-el7,latest                                             NO
   php         openshift     7.2-ubi7,7.2-ubi8,7.3-ubi7,7.3-ubi8,latest                                     NO
   python      openshift     2.7-ubi7,2.7-ubi8,3.6-ubi7,3.6-ubi8,3.8-ubi7,3.8-ubi8,latest                   NO
   ruby        openshift     2.5-ubi7,2.5-ubi8,2.6-ubi7,2.6-ubi8,2.7-ubi7,latest                            NO
   wildfly     openshift     10.0,10.1,11.0,12.0,13.0,14.0,15.0,16.0,17.0,18.0,19.0,20.0,8.1,9.0,latest     NO

Procedure

1. Create a directory to store the source code of your component:

   $ mkdir <directory-name>

2. Create a component configuration of Spring Boot component type named myspring and download its sample project:

   $ odo create java-spring-boot myspring --starter

   The previous command produces the following output:

   Experimental mode is enabled, use at your own risk
   
   Validation
   ✓  Checking devfile compatibility [195728ns]
   ✓  Creating a devfile component from registry: DefaultDevfileRegistry [170275ns]
   ✓  Validating devfile component [281940ns]
   
   Please use `odo push` command to create the component with source deployed

   The odo create command downloads the associated devfile.yaml file from the recorded devfile registries.

3. List the contents of the directory to confirm that the devfile and the sample Java application were downloaded:

   $ ls

   The previous command produces the following output:

   README.md    devfile.yaml    pom.xml        src

4. Create a URL to access the deployed component:

   $ odo url create --host apps-crc.testing

   The previous command produces the following output:

   ✓  URL myspring-8080.apps-crc.testing created for component: myspring
   
   To apply the URL configuration changes, please use odo push

   注意

   You must use your cluster host domain name when creating the URL.

5. Push the component to the cluster:

   $ odo push

   The previous command produces the following output:

   Validation
    ✓  Validating the devfile [81808ns]
   
   Creating Kubernetes resources for component myspring
    ✓  Waiting for component to start [5s]
   
   Applying URL changes
    ✓  URL myspring-8080: http://myspring-8080.apps-crc.testing created
   
   Syncing to component myspring
    ✓  Checking files for pushing [2ms]
    ✓  Syncing files to the component [1s]
   
   Executing devfile commands for component myspring
    ✓  Executing devbuild command "/artifacts/bin/build-container-full.sh" [1m]
    ✓  Executing devrun command "/artifacts/bin/start-server.sh" [2s]
   
   Pushing devfile component myspring
    ✓  Changes successfully pushed to component

6. List the URLs of the component to verify that the component was pushed successfully:

   $ odo url list

   The previous command produces the following output:

   Found the following URLs for component myspring
   NAME              URL                                       PORT     SECURE
   myspring-8080     http://myspring-8080.apps-crc.testing     8080     false

7. View your deployed application by using the generated URL:

   $ curl http://myspring-8080.apps-crc.testing