Welcome!

Microservices Expo Authors: Derek Weeks, Liz McMillan, Elizabeth White, John Katrick, Pat Romanski

Related Topics: Microservices Expo

Microservices Expo: Article

Service-Oriented Architecture Best Practices

Meeting your goals takes a mixed effort

The concept of a service-oriented architecture is a powerful tool for simplifying enterprise integration. Following the three principles of modularity, encapsulation and loose coupling will achieve some amount of improvement for an individual service. It is insufficient to have a loose set of principles to guide enterprise architecture designs. It is also important to have "best practices" on how to build, run and manage enterprise systems. This document will cover the best practices that have been culled from Epiphany, a number of Epiphany's top customers and leading analyst firms.

Define the language of your enterprise. First and foremost, there must be a common language that your, enterprise must speak. This amounts to being able to define important entities as XML Schemas and transformations as XML style sheets. Enforcement is crucial, as well ensuring interoperability across an enterprise wide system. This is the single most important action an enterprise can take to smooth its transition to an SOA.

In one sense, this principle should not be necessary if industry standards groups could agree on basic XML document formats for simple things like names and addresses. Since this is unlikely to happen anytime soon, it is important that your organization set its own language policies now, and deal with transformation issues via XSLT later.

Establish a naming convention for your enterprise. In a SOA environment, having a document that formulates how to name Web services, service interfaces, legacy system endpoints, or any public component will help the enterprise architects, administrators, and developers provide consistent services.

Define service interfaces first, implement later. In a SOA, the interface for a Web service is more important than its actual implementation. When designing composite applications (i.e. applications composed from a cluster of web services), recognize that heterogeneity is the norm. One analyst study put the average number of hardware/software platforms in the Fortune 500 at 6. This underscores setting a baseline "language" for your organization, as heterogeneity is an unavoidable fact in any large enterprise.

In addition to having best practices around people, practices, and technology, it is also important to have "design patterns" that can be reused in order to make the design and construction of an SOA faster and easier. Just as there are design patterns for object-oriented programming, there is a group of experts who are looking at describing common enterprise workflows as a set of patterns. Led by BEA and the Middleware Company, initial work has been done to catalog a number of enterprise workflows captured as patterns for an SOA. While their efforts are in the early stage, the work appears promising.

Establish a service categorization. Services come in a number of flavors. An organization should decide on its services taxonomy. This definition will help to define development roles, as well as help to suggest a level or organizational structure. At a high level, there are only a few types of services. The Middleware Company group is attempting to pull together a set of best practices for building out a service-oriented architecture. The expert group has defined a taxonomy of services, which is a useful starting place:

  • Component services: Simple atomic services potentially acting on single enterprise resource (e.g., database, code, etc).
  • Data services: Service providing data querying, combination and transformation for multiple data sources.
  • Business services: Atomic services composed of combinations of component services and rules.
  • Workflow services: Long lived business processes coordinating other services with external interactions.
Separate rules. It is important to categorize business logic/rules, further, into "process" type business rules versus "UI" type business rules. Process-type business rules are good candidates to encompass within business services and UI-level business rules should be separated out.

Don't skimp on training. Start with a common skill set. Most organizations are new to the technologies behind SOA (like WS-I, WS-BPEL, etc.), so it is important for an IT staff to acquire the skills to understand and implement SOA on an enterprise-wide scale.

Architect a common management layer. A service-oriented architecture provides both additional opportunity and complexity for managing an operational system. Many of the infrastructure vendors like IBM and BEA provide the ability to monitor and manage Web services. It is important to implement a uniform management infrastructure for managing hardware, operating systems, applications, and Web services for maximum visibility.

Analyst firms have begun to discuss implementation issues around SOA as well. In a recent report, Forrester offers several suggestions for SOA best practices. The Forrester report offers several points for enterprises to consider:

Align services with business processes. This is important for a number of reasons. First, the service must be understood by the business users for it to be useful and successful. Second, the service should match the business process it is managing to mitigate the need to change management. Third, change management will be easier. As business processes change, determining which services need to change will be made easier.

Design decisions need to be made regarding integrating business rules within services. Consumer application-specific business rules may not have to be integrated within the producer services if there is no value in having these rules apply to other consumer applications. This also facilitates easy maintenance of services because there is less coordination with multiple consumer applications

Start with services, do Web services later. Moving to an SOA does not necessarily require Web services. Many companies have been successful building out an SOA message-oriented middleware (MOM). This includes JMS-based software as well as IBM WebSphere MQ (the former MQSeries). Applications rooted in MOM-based systems generally met the requirements of SOA: encapsulation, loose-coupling and modularity, but with the notion of messages on a queue rather than SOAP/XML messages.

Wrap packaged applications in service interfaces. This was mentioned above, but is important enough to restate. Enterprises should be wary of vendors claiming to provide a platform. Leveraging a single vendor's platform will unnecessarily tie an organization to one vendor. This is a risky strategy. It is better for enterprise information assets to speak a neutral, common language that will ensure interoperability.

Have a version resolution architecture. Web services present the ability to reuse software like never before. A Web service can be a public resource used by hundreds of applications. However, if the Web service changes the applications will have to change. This will create a maintenance nightmare. It is important to have an architecture where interfaces have a version associated with them, and a way of resolving a particular interface to a particular version. As Web service producers are changed, the consumers can be migrated slowly to the new service. This way disruption is minimized.

Conclusion
Successful enterprises know that achieving an organization's goals is a mix of best practices around people, policies, and technology. This article has attempted to illustrate that it is not sufficient to adopt SOA technologies. It is important to adopt best practices around how a group is organized and how it behaves. It is also important to adopt a set of policies that ensure smooth, visible operations and minimal effort in the face of change. This article has attempted show some of the current thinking around best practices from Epiphany, Epiphany's customers, and leading analyst firms. The nascent body of SOA best practices is still developing.

Resources

  • Some efforts in this area, like xNAL, are by no means universally accepted. See http://xml.coverpages.org/xnal.html for more details.
  • Gamma, E., et al. (1995). Design Patterns: Elements of Reusable Object-Oriented Softwar. Addison Wesley.
  • SOA Blueprints: www.middlewareresearch.com/soa-blueprints/
  • More Stories By Bill Roth

    Bill Roth is a Silicon Valley veteran with over 20 years in the industry. He has played numerous product marketing, product management and engineering roles at companies like BEA, Sun, Morgan Stanley, and EBay Enterprise. He was recently named one of the World's 30 Most Influential Cloud Bloggers.

    Comments (1) View Comments

    Share your thoughts on this story.

    Add your comment
    You must be signed in to add a comment. Sign-in | Register

    In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.


    Most Recent Comments
    David Knox 02/10/05 11:05:08 AM EST

    This arcticle starts off right with the three bastions of SOA (standardized interfaces, separation of concerns, loose coupling), after that it falls off the edge. I was most alarmed by the notion that SOA requires 'common language'. The author's argument clearly implies that an enterprise architecture must mandate an all XML protocol. I find it difficult to believe that J2EE app servers shouldn't freely use RMI-IIOP between containers. If every application in the enterprise must have the same transport protocol it contradicts the edict of loose coupling. In the first paragraph the author states a working SOA definition, in the second the author contradicts a necessary aspect of SOA.

    @MicroservicesExpo Stories
    Some people are directors, managers, and administrators. Others are disrupters. Eddie Webb (@edwardawebb) is an IT Disrupter for Software Development Platforms at Liberty Mutual and was a presenter at the 2016 All Day DevOps conference. His talk, Organically DevOps: Building Quality and Security into the Software Supply Chain at Liberty Mutual, looked at Liberty Mutual's transformation to Continuous Integration, Continuous Delivery, and DevOps. For a large, heavily regulated industry, this task...
    Modern software design has fundamentally changed how we manage applications, causing many to turn to containers as the new virtual machine for resource management. As container adoption grows beyond stateless applications to stateful workloads, the need for persistent storage is foundational - something customers routinely cite as a top pain point. In his session at @DevOpsSummit at 21st Cloud Expo, Bill Borsari, Head of Systems Engineering at Datera, explored how organizations can reap the bene...
    Kubernetes is an open source system for automating deployment, scaling, and management of containerized applications. Kubernetes was originally built by Google, leveraging years of experience with managing container workloads, and is now a Cloud Native Compute Foundation (CNCF) project. Kubernetes has been widely adopted by the community, supported on all major public and private cloud providers, and is gaining rapid adoption in enterprises. However, Kubernetes may seem intimidating and complex ...
    Gaining visibility in today’s sprawling cloud infrastructure is complex and laborious, involving drilling down into tools offered by various cloud services providers. Enterprise IT organizations need smarter and effective tools at their disposal in order to address this pertinent problem. Gaining a 360 - degree view of the cloud costs requires collection and analysis of the cost data across all cloud infrastructures used inside an enterprise.
    You know you need the cloud, but you’re hesitant to simply dump everything at Amazon since you know that not all workloads are suitable for cloud. You know that you want the kind of ease of use and scalability that you get with public cloud, but your applications are architected in a way that makes the public cloud a non-starter. You’re looking at private cloud solutions based on hyperconverged infrastructure, but you’re concerned with the limits inherent in those technologies.
    Gone are the days when application development was the daunting task of the highly skilled developers backed with strong IT skills, low code application development has democratized app development and empowered a new generation of citizen developers. There was a time when app development was in the domain of people with complex coding and technical skills. We called these people by various names like programmers, coders, techies, and they usually worked in a world oblivious of the everyday pri...
    Our work, both with clients and with tools, has lead us to wonder how it is that organizations are handling compliance issues in the cloud. The big cloud vendors offer compliance for their infrastructure, but the shared responsibility model requires that you take certain steps to meet compliance requirements. Which lead us to start poking around a little more. We wanted to get a picture of what was available, and how it was being used. There is a lot of fluidity in this space, as in all things ...
    The dynamic nature of the cloud means that change is a constant when it comes to modern cloud-based infrastructure. Delivering modern applications to end users, therefore, is a constantly shifting challenge. Delivery automation helps IT Ops teams ensure that apps are providing an optimal end user experience over hybrid-cloud and multi-cloud environments, no matter what the current state of the infrastructure is. To employ a delivery automation strategy that reflects your business rules, making r...
    The notion of improving operational efficiency is conspicuously absent from the healthcare debate - neither Obamacare nor the newly proposed GOP plan discusses the impact that a step-function improvement in efficiency could have on access to healthcare (through more capacity), quality of healthcare services (through reduced wait times for patients) or cost (through better utilization of scarce, expensive assets).
    Admiral Calcote - also known as Lee Calcote (@lcalcote) or the Ginger Geek to his friends - gave a presentation entitled Characterizing and Contrasting Container Orchestrators at the 2016 All Day DevOps conference. Okay, he isn't really an admiral - nor does anyone call him that - but he used the title admiral to describe what container orchestrators do, relating it to an admiral directing a fleet of container ships. You could also say that they are like the conductor of an orchestra, directing...
    Cloud Governance means many things to many people. Heck, just the word cloud means different things depending on who you are talking to. While definitions can vary, controlling access to cloud resources is invariably a central piece of any governance program. Enterprise cloud computing has transformed IT. Cloud computing decreases time-to-market, improves agility by allowing businesses to adapt quickly to changing market demands, and, ultimately, drives down costs.
    For DevOps teams, the concepts behind service-oriented architecture (SOA) are nothing new. A style of software design initially made popular in the 1990s, SOA was an alternative to a monolithic application; essentially a collection of coarse-grained components that communicated with each other. Communication would involve either simple data passing or two or more services coordinating some activity. SOA served as a valid approach to solving many architectural problems faced by businesses, as app...
    SYS-CON Events announced today that Synametrics Technologies will exhibit at SYS-CON's 22nd International Cloud Expo®, which will take place on June 5-7, 2018, at the Javits Center in New York, NY. Synametrics Technologies is a privately held company based in Plainsboro, New Jersey that has been providing solutions for the developer community since 1997. Based on the success of its initial product offerings such as WinSQL, Xeams, SynaMan and Syncrify, Synametrics continues to create and hone in...
    Some journey to cloud on a mission, others, a deadline. Change management is useful when migrating to public, private or hybrid cloud environments in either case. For most, stakeholder engagement peaks during the planning and post migration phases of a project. Legacy engagements are fairly direct: projects follow a linear progression of activities (the “waterfall” approach) – change managers and application coders work from the same functional and technical requirements. Enablement and develo...
    The “Digital Era” is forcing us to engage with new methods to build, operate and maintain applications. This transformation also implies an evolution to more and more intelligent applications to better engage with the customers, while creating significant market differentiators. In both cases, the cloud has become a key enabler to embrace this digital revolution. So, moving to the cloud is no longer the question; the new questions are HOW and WHEN. To make this equation even more complex, most ...
    Recent survey done across top 500 fortune companies shows almost 70% of the CIO have either heard about IAC from their infrastructure head or they are on their way to implement IAC. Yet if you look under the hood while some level of automation has been done, most of the infrastructure is still managed in much tradition/legacy way. So, what is Infrastructure as Code? how do you determine if your IT infrastructure is truly automated?
    Every few years, a disruptive force comes along that prompts us to reframe our understanding of what something means, or how it works. For years, the notion of what a computer is and how you make one went pretty much unchallenged. Then virtualization came along, followed by cloud computing, and most recently containers. Suddenly the old rules no longer seemed to apply, or at least they didn’t always apply. These disruptors made us reconsider our IT worldview.
    As people view cloud as a preferred option to build IT systems, the size of the cloud-based system is getting bigger and more complex. As the system gets bigger, more people need to collaborate from design to management. As more people collaborate to create a bigger system, the need for a systematic approach to automate the process is required. Just as in software, cloud now needs DevOps. In this session, the audience can see how people can solve this issue with a visual model. Visual models ha...
    Containers are rapidly finding their way into enterprise data centers, but change is difficult. How do enterprises transform their architecture with technologies like containers without losing the reliable components of their current solutions? In his session at @DevOpsSummit at 21st Cloud Expo, Tony Campbell, Director, Educational Services at CoreOS, will explore the challenges organizations are facing today as they move to containers and go over how Kubernetes applications can deploy with lega...
    Nordstrom is transforming the way that they do business and the cloud is the key to enabling speed and hyper personalized customer experiences. In his session at 21st Cloud Expo, Ken Schow, VP of Engineering at Nordstrom, will discuss some of the key learnings and common pitfalls of large enterprises moving to the cloud. This includes strategies around choosing a cloud provider(s), architecture, and lessons learned. In addition, he’ll go over some of the best practices for structured team migrat...