Joget Workflow v5 Training Slides - Module 22 - Best Practices on Application Building
Application module slides
Transcript of Application module slides
2 © Copyright IBM Corporation 2013
Module overview
After completing this module, you should be able to complete these tasks:
Create and properly scope Applications Create environments and Application processes Create tags Use and create approvals, notifications, and status gates Use and create properties Create blueprints
3 © Copyright IBM Corporation 2013
What are applications?
Applications handle orchestration of deployments to a target environment
4 © Copyright IBM Corporation 2013
Application terminology• Components
• Must define which components belong to the application
• Environments• Define target servers• Add specific resources to
environment
• Processes• Define steps to install, configure,
rollback
• Blueprints• Set up a new environment quickly
5 © Copyright IBM Corporation 2013
Application scoping
Defining an application:• Determine what components need to be deployed
together
Components Composite Application
6 © Copyright IBM Corporation 2013
Creating an application
Click on Applications Tab
Click on Create New Application
1.
2.
7 © Copyright IBM Corporation 2013
Creating an application
3.
Fill out information and click Save button
Application now shows up in Applications list
8 © Copyright IBM Corporation 2013
Adding components to an application
Choose the Application needing components
1.
2.Click on Components tab
Before adding components to an application, they need to be created first. See Components module for more information on creating components
9 © Copyright IBM Corporation 2013
Adding components to an application
Choose the Application needing components
3.
Choose the components to add
4.
The components added here will also need to be added to an application environment. Instructions on how to add these resources to environments are available on the “Adding Resources to Environment” slide.
10 © Copyright IBM Corporation 2013
Applications: environments
Environments are a collection of resources to required to host an instance of an application.
• Resources include agents (servers) and components
Environment resources
11 © Copyright IBM Corporation 2013
Applications: Environments
• Environments within Applications can have different topologies, configurations, and settings for the environment
12 © Copyright IBM Corporation 2013
Environment topologies
A single server with an agent installed contains all three components: Database, Web, and Config
Two servers with an agent installed on each. The DB server contains the Database component and the Web server contains the Web and Config components
A more distributed and production-ready topology. Each server has an agent installed with the DB server still containing the Database component, but there are load-balanced Web Servers that each contain a Web and Config component
13 © Copyright IBM Corporation 2013
Creating an Environment
Click on Applications Tab1.
Click on Create New Environment
2.
14 © Copyright IBM Corporation 2013
Creating an environment
Fill out fields and click Save button
3.
15 © Copyright IBM Corporation 2013
Adding Resources to Environment
Under Environments tab, choose environment to add resources to
1.
Before adding resources to an environment, they need to be created first. See Resources module for more information on creating agents
16 © Copyright IBM Corporation 2013
Adding Resources to an Environment
2.Under Resources tab, click on Add Base Resources
Choose Resources to add to the environment
17 © Copyright IBM Corporation 2013
Applications: Processes
Application Processes provide overall deployment orchestration.
Steps in an application process represent the various component processes and tasks necessary to perform a deployment.
18 © Copyright IBM Corporation 2013
Application processes versus component processes
• In many cases, application processes call component processes.
• Application processes run on the server; component processes run on an agent.
• Application process steps do not come from plug-ins.
• Component process steps come from plug-ins. • Component processes (created from plug-in steps)
operate on plug-ins.
19 © Copyright IBM Corporation 2013
Creating an Application Process
Under Applications tab, choose the application for the process
1.
Choose the Processes tab2.
20 © Copyright IBM Corporation 2013
Creating an Application Process
3.Click the Create New Process button
21 © Copyright IBM Corporation 2013
Application Process Steps
Choose a component deployment
process to run
Deploy multiple components in
one step
Remove all component
versions from the environment
Switch between different
incremental component
versions
Runs a component process for each
component versionRuns a generic
process on each resource that is affected in the
application process
Runs an Operational (non-version) or
config deployment process
22 © Copyright IBM Corporation 2013
Application Process – Tag Usage
Tags can be set on resources within an environment to exercise fine-grained control over which resources a deployment is run on. A common use for this is in a load-balancing situation.
23 © Copyright IBM Corporation 2013
Application Process – Tag Usage
When adding an Install Component step, there is a choice to limit the deployment to a specific resource tag
24 © Copyright IBM Corporation 2013
Application Approvals and Status Gates
In addition to roles and permissions, there are ways to ensure an environment is not tampered with or left in an undesirable state
Environment approvals can be set to require an administrator or manager to approve a process run against an environment
• Particularly useful in production environments
Status Gates can check a component version in an environment for a certain status before that version is deployed
• Example – Only deploy component versions with a “Passed all tests” status
25 © Copyright IBM Corporation 2013
Creating Approvals
Choose the environment that needs approvals enabled
1.
Click on Configuration tab
2.
26 © Copyright IBM Corporation 2013
Creating Approvals
Check Require Approvals box and Save the settings
3.
27 © Copyright IBM Corporation 2013
Creating Approvals
Check Require Approvals box and Save the settings
4.
28 © Copyright IBM Corporation 2013
Creating Approvals
Choose from three approval tasks
Each approval task can be associated with approvers with different roles. If all three tasks are selected, the environment will require three separate approvals to move forward with a process.
5.
30 © Copyright IBM Corporation 2013
Creating Status Gates
Click the Add Status button
Enter details and Save
3
4
31 © Copyright IBM Corporation 2013
Creating Status Gates
5
6
7Choose environment that requires gate(s) and add conditions
32 © Copyright IBM Corporation 2013
Application Notifications
Add a notification scheme to the application• Notifications will be sent out to appropriate parties
based on scheme• Create schemes and configure mail settings under
main Settings tab
1
2
3
33 © Copyright IBM Corporation 2013
Application Properties
Application properties can be accessed by any application process or component process run against an environment within the application
1
2
3
36 © Copyright IBM Corporation 2013
Demonstration: Demo name
The instructor will show you how to complete these tasks:
Do this.
And this.
37 © Copyright IBM Corporation 2013
Exercise
The goal of this exercise is …
Try the following: Do this. And this.
38 © Copyright IBM Corporation 2013
Discussion
Working in groups, discuss these questions:
How was your approach different in terms of language and diagrams? Better or worse?
What would make it better? Tooling? Process? Training?
40 © Copyright IBM Corporation 2013
Review
Why should you do this?
What are the best practices for this?
Name some examples of when you might need to do this.
42 © Copyright IBM Corporation 2013
Further information Additional training
www.ibm.com/trainingRational software training:
http://www.ibm.com/training/us/catalog/rational/
Information center (online help)http://www.ibm.com/support/publications/us/library/index.shtml#softwarehttp://publib.boulder.ibm.com/infocenter/rsdp/v1r0m0/index.jsp
Supporthttp://www.ibm.com/planetwide/http://www.ibm.com/support
developerWorks® for webcasts, workshops, white papers, demonstrations, and other information
http://www.ibm.com/developerworks/rational
Forumshttp://www-947.ibm.com/support/entry/portal/Forums_communities
Blog
Facebookhttp://www.facebook.com/IBMRational
Twitterhttp://twitter.com/ibmrational
Web
Video
Books and articles
• Make multiple copies of this slide if needed so that the text size can be made larger. Also, the page image is optional, and may be removed.• Links here are examples, but may be used if appropriate.
43 © Copyright IBM Corporation 2013
Course surveyPlease complete the course survey
If you have web access in class, go to http://osart.atlanta.ibm.com.
If you do not have web access, an email will be sent to you.– Please provide the instructor with your name and email address.
– Please wait for the email.
Class Number: __________
Provided by instructor
Course Code: _______
If you are taking multiple courses, please complete a survey for each course and request certificates for each as well.
44 © Copyright IBM Corporation 2013
Course legal noticesEditors: customize this as necessary and remove comments in blue font. The following paragraph does not apply to the United Kingdom or any other country where such provisions
are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.
If you are viewing this information in softcopy, the photographs and color illustrations may not appear. Remove if not mentioned in course: Any references in this information to non-IBM websites are provided for
convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk.
Only applicable if performance is discussed: Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.
Remove if not mentioned in course: Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
Include only in beta versions or versions made available before the product GAs. (Keep the "IBM's future direction" statement in all courses that make any reference to future direction or intent.): This information is for planning purposes only. The information herein is subject to change before the products described become available.
Include this statement if course mentions future directions or intent: All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.
45 © Copyright IBM Corporation 2013
Course legal notices (cont.) Consider labs: This information contains examples of data and reports used in daily business operations. To illustrate
them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.
Consider labs: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.
Trademarks and service marks Include this statement (make sure you have marked ALL IBM trademarks correctly): IBM, the IBM logo, and
ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at www.ibm.com/legal/copytrade.shtml.
Remove this section after completing the steps:1. Go to http://www.ibm.com/legal/us/en/copytrade.shtml#section_4 and review the special non-IBM trademarks that
our publications must acknowledge.2. Review your course for the trademarks that are listed on the web page—and only the trademarks listed.3. Follow these situations and examples to generate the acknowledgement statements for the special non-IBM
trademarks.– Your document includes “Microsoft” and “Windows.” The acknowledgment statement would be as follows:
Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both. [The document does not include “Windows NT” or the “Windows logo,” so you do not provide attribution to them.]
– Your document includes only “Visual Studio,” which is a Microsoft trademark. Do not acknowledge this trademark.
– Your document includes "Java" or Java-related logos. The acknowledgment state would be: Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates..
Always keep this statement: Other company, product, or service names may be trademarks or service marks of others.
47 © Copyright IBM Corporation 2013
Style and graphicsThese slides contain information about these aspects of creating course presentations:
IBM Style Top Style topics Keyboard keys Menu instructions and navigation IBM Style on the web (if you cannot access Style in Lotus Notes)
Annotated Screen Captures “Standard” annotated screen capture treatment “Thumbnail zoom-in” treatment “Numbered annotation” treatment Style settings
Reusable Elements Icons
Remove this slide
48 © Copyright IBM Corporation 2013
Standard annotated screen capture Remove this slide
Bracket/callout (Text: Arial 14pt or larger)
Highlight/arrow/callout (Text: Arial 14pt or larger)
Note (Text: Arial 14pt or larger)
The main treatment to use is "Highlight/arrow/call-out box".
To discuss parts of the UI that are on top of one another, the bottom area is given a "bracket/callout" treatment.
Notes are used for general statements.
Note: Style settings for all the design elements (boxes, line styles, color etc.) are detailed on following slides. However, you can just copy/paste the elements you need from these slides.
When you use a callout box with an arrow, make sure the text box is on top of the arrow. Select the callout, and then click Draw > Order > Bring to Front.
Attention: Text smaller than 18 pt may not be legible when slides are displayed.
49 © Copyright IBM Corporation 2013
Thumbnail zoom-in treatment
Thumbnail
Zoom-in
For the Thumbnail:
1. Select, Insert > Picture > From File
2. Select, Format picture > Size > Scale by 30 %
3. Use a rounded rectangle to highlight the required area of focus
For the Zoom-in:
1. Insert a screen capture of the focus area
2. Select, Format picture > Colours and Lines
3. Line: solid R:227, G:118, B:25
Remove this slide
50 © Copyright IBM Corporation 2013
Numbered annotations
1
2
3
4
5
6
Use the rounded rectangle
to highlight required areas
of the UI.
Attach the numbered box to the side of the rounded rectangle.
1
Remove this slide
51 © Copyright IBM Corporation 2013
Highlight box and arrow custom settingsHighlight box Select: Insert/Picture/AutoShapes
From the AutoShapes box: Select: Basic Shapes/Rounded rectangle
Fill color: none
Outline color: R: 227, G: 118, B: 25 (#E37619)
Weight: 2.0 pt
Arrow Weight: 1.5 pt
Outline color R: 227 G: 118, B: 25
Style: Arrow R size 9
Remove this slide
52 © Copyright IBM Corporation 2013
Call-out box custom settingsCall-out box Select: Insert/Picture/AutoShapes
From the AutoShapes box: Select: Basic Shapes/Rectangle
Fill color: R:255, G, 250, B: 225
Outline color: R: 227, G: 118, B: 25
Weight: 1.5 pt
Remove this slide
53 © Copyright IBM Corporation 2013
Note box Select: Insert/Picture/AutoShapes
From the AutoShapes box: Select: Basic Shapes/Rectangle
Fill color R: 249, G: 227, B: 169
Outline color R: 227, G: 118, B: 25
Weight: 1.5 pt
Note box custom settings Remove this slide
54 © Copyright IBM Corporation 2013
IconsThese icons are available for use where appropriate.
“Best practice” generic
“Attention”
“Check-results”
“Close”
“Do it” (Use for a student activity)
“Download”
“Download-PDF”
“Example”
“Full view” or “enlarge”
“Lab”
“Note”
“Play” - for starting demos or animations.
“Play” inactive
“Practice” for MCIF
“Thought Question”
“Tip” “Hint” or “Info”
Icons for links to additional information outside of the course:
See also: http://stwweb1.torolab.ibm.com/igraphics/Cueing/reusable/iconic.html
Text-based documentation
Tutorials
DeveloperWorks
Education (Courses)
Help
Multimedia
Samples
Support
Remove this slide
Web