Oracle® Cloud Using Oracle Application Container Cloud Service E64179-32 Sep 2019 Oracle Cloud Using Oracle Application Container Cloud Service, E64179-32 Copyright © 2015, 2019, Oracle and/or its affiliates. All rights reserved. Primary Authors: Rebecca Parks, Marilyn Beck, Rob Gray Contributing Authors: Michael W. Williams This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable: U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency- specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government. This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle. Contents Preface Audience v Documentation Accessibility v Related Resources v Conventions v 1 Getting Started with Oracle Application Container Cloud Service About Oracle Application Container Cloud Service 1-1 Before You Begin with Oracle Application Container Cloud Service 1-2 Access Oracle Application Container Cloud Service 1-3 Access Oracle Application Container Cloud Service from Oracle Cloud Infrastructure Console 1-3 Access Oracle Application Container Cloud Service from Oracle Cloud Infrastructure Classic Console 1-3 About Oracle Application Container Cloud Service Roles and Users 1-4 2 Administering Applications Typical Workflow for Administering Applications 2-1 Explore the Applications Page 2-2 Create an Application 2-3 Configure a Vanity URL 2-5 Use the Application Console 2-6 Stop, Start, and Restart an Application 2-7 Delete an Application 2-8 Explore the Application Overview Page 2-9 Scale an Application Out or In 2-10 Scale an Application Up or Down 2-10 Considerations when Scaling Applications 2-10 Explore the Application Deployments Page 2-10 Redeploy an Application 2-11 Manage Service Bindings 2-12 iii Configure Environment Variables 2-13 Explore the Application Administration Page 2-15 View Service Metrics for an Application 2-15 View Activity for Service Instances 2-16 Retrieve the Application Logs 2-17 Automatically Scaling an Application 2-17 Manage Tags 2-18 Create, Assign, and Unassign Tags 2-18 Find Tags and Applications Using Search Expressions 2-19 3 Using Oracle Application Container Cloud Service with Other Oracle Cloud Services Use Oracle Identity Cloud Service with Oracle Application Container Cloud Service 3-1 Deploy an Application and Configure a Database with Stack Manager 3-2 iv Preface Using Oracle Application Container Cloud Service tells you how to deploy applications and describes the web user interface. Topics: • Audience • Documentation Accessibility • Related Resources • Conventions Audience This document is primarily for administrators who are responsible for provisioning an Oracle Cloud service, monitoring service usage and performance, and deploying applications. Documentation Accessibility For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup? ctx=acc&id=docacc. Access to Oracle Support Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/ lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired. Related Resources See Oracle Public Cloud. Conventions The following text conventions are used in this document: Convention Meaning boldface Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary. v Preface Convention Meaning italic Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values. monospace Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter. vi 1 Getting Started with Oracle Application Container Cloud Service Get started with general information about using Oracle Application Container Cloud Service. Topics: • About Oracle Application Container Cloud Service • Before You Begin with Oracle Application Container Cloud Service • Access Oracle Application Container Cloud Service • About Oracle Application Container Cloud Service Roles and Users About Oracle Application Container Cloud Service Oracle Application Container Cloud Service lets you deploy Java SE, Node.js, PHP, Python, Ruby, Go, and .NET Core applications to the Oracle Cloud. You can also deploy Java EE web applications. Subscribing to Oracle Application Container Cloud Service makes all types of applications available when you deploy your application. Your application runs in a Docker container. With Oracle Application Container Cloud Service, you can use these key features: • A preconfigured environment for Java SE, Java EE, Node.js, PHP, Python, Ruby, Go, and .NET Core applications. 1-1 Chapter 1 Before You Begin with Oracle Application Container Cloud Service • Java SE advanced features such as Java Flight Recorder, Java Mission Control, advanced memory management, and ongoing and timely security updates. • An Open platform that supports all Java frameworks and containers such as Spring, Play, Tomcat, and Jersey. • Support for Java Virtual Machine (JVM) based languages such as JRuby. You can run any language that uses the JVM on this service. • Enterprise-grade support from Oracle. • Web-based user interface and REST API. In addition, you can integrate with other Oracle Cloud services, develop your application on your local system, or use Oracle Developer Cloud Service. If you want to store and retrieve data, then you can use Oracle Cloud Infrastructure Object Storage Classic — a subscription is included. You can also subscribe to Oracle Database Cloud Service or Oracle MySQL Cloud Service. To deploy an application and configure a database in a single step, you can use Oracle Cloud Stack. For communication, you can subscribe to Oracle Messaging Cloud Service. Your application communicates with that service through its REST API, so no special security configuration is necessary. Before You Begin with Oracle Application Container Cloud Service Before using Oracle Application Container Cloud Service, ensure that your Oracle Cloud Infrastructure Object Storage Classic account is active. You must also have the necessary user roles. It’s also useful to be familiar with other related Oracle Cloud services and the technologies that Oracle Application Container Cloud Service uses, such as Java SE, Java Flight Recorder, and Java Mission Control. For details about service activation, see