From 997fbded10d98da6588b582a90f8716be56333d9 Mon Sep 17 00:00:00 2001 From: xiangxinyong Date: Thu, 8 Oct 2015 18:51:33 +0800 Subject: [PATCH] [MongoDB] Application added MongoDB is a cross-platform document-oriented database. Classified as a NoSQL database, MongoDB eschews the traditional table-based relational database structure in favor of JSON-like documents with dynamic schemas. Change-Id: Ica7a6e2b8e8cb903f5c34ce38386d1e179e1e9e7 Implements: blueprint add-mongodb-app --- MongoDB/package/Classes/MongoDB.yaml | 101 ++++++++++ MongoDB/package/LICENSE | 175 ++++++++++++++++++ .../Resources/AddFirewallRules.template | 31 ++++ .../Resources/ConfigureMongoDB.template | 31 ++++ .../Resources/CreateMongoDBDatabase.template | 31 ++++ .../CreateUserForMongoDBDatabase.template | 33 ++++ .../package/Resources/DeployMongoDB.template | 31 ++++ .../Resources/scripts/addFirewallRules.sh | 15 ++ .../Resources/scripts/configureMongoDB.sh | 36 ++++ .../scripts/createMongoDBDatabase.sh | 20 ++ .../scripts/createUserForMongoDBDatabase.sh | 17 ++ .../Resources/scripts/deployMongoDB.sh | 15 ++ MongoDB/package/UI/ui.yaml | 127 +++++++++++++ MongoDB/package/logo.png | Bin 0 -> 5415 bytes MongoDB/package/manifest.yaml | 25 +++ 15 files changed, 688 insertions(+) create mode 100644 MongoDB/package/Classes/MongoDB.yaml create mode 100644 MongoDB/package/LICENSE create mode 100644 MongoDB/package/Resources/AddFirewallRules.template create mode 100644 MongoDB/package/Resources/ConfigureMongoDB.template create mode 100644 MongoDB/package/Resources/CreateMongoDBDatabase.template create mode 100644 MongoDB/package/Resources/CreateUserForMongoDBDatabase.template create mode 100644 MongoDB/package/Resources/DeployMongoDB.template create mode 100644 MongoDB/package/Resources/scripts/addFirewallRules.sh create mode 100644 MongoDB/package/Resources/scripts/configureMongoDB.sh create mode 100644 MongoDB/package/Resources/scripts/createMongoDBDatabase.sh create mode 100644 MongoDB/package/Resources/scripts/createUserForMongoDBDatabase.sh create mode 100644 MongoDB/package/Resources/scripts/deployMongoDB.sh create mode 100644 MongoDB/package/UI/ui.yaml create mode 100644 MongoDB/package/logo.png create mode 100644 MongoDB/package/manifest.yaml diff --git a/MongoDB/package/Classes/MongoDB.yaml b/MongoDB/package/Classes/MongoDB.yaml new file mode 100644 index 00000000..26c90438 --- /dev/null +++ b/MongoDB/package/Classes/MongoDB.yaml @@ -0,0 +1,101 @@ +# Licensed under the Apache License, Version 2.0 (the "License"); you may +# not use this file except in compliance with the License. You may obtain +# a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations +# under the License. + +Namespaces: + =: io.murano.databases + std: io.murano + res: io.murano.resources + sys: io.murano.system + + +Name: MongoDB + +Extends: std:Application + +Properties: + instance: + Contract: $.class(res:Instance).notNull() + database: + Contract: $.string() + username: + Contract: $.string() + password: + Contract: $.string() + +Methods: + initialize: + Body: + - $._environment: $.find(std:Environment).require() + + deploy: + Body: + - If: not $.getAttr(deployed, false) + Then: + # Create VM for MongoDB + - $._environment.reporter.report($this, 'Creating VM for MongoDB.') + - $securityGroupIngress: + - ToPort: 27017 + FromPort: 27017 + IpProtocol: tcp + External: true + - ToPort: 28017 + FromPort: 28017 + IpProtocol: tcp + External: true + - $._environment.securityGroupManager.addGroupIngress($securityGroupIngress) + - $.instance.deploy() + - $resources: new(sys:Resources) + + # Deploy MongoDB + - $template: $resources.yaml('DeployMongoDB.template') + - $._environment.reporter.report($this, 'Deploying MongoDB.') + - $.instance.agent.call($template, $resources) + + # Configure MongoDB + - $template: $resources.yaml('ConfigureMongoDB.template') + - $._environment.reporter.report($this, 'Configuring MongoDB.') + - $.instance.agent.call($template, $resources) + + # Add firewall rules + - $template: $resources.yaml('AddFirewallRules.template') + - $._environment.reporter.report($this, 'Adding firewall rules for MongoDB.') + - $.instance.agent.call($template, $resources) + + # Create database on MongoDB + - If: $.database != '' and $.database != null + Then: + - $template: $resources.yaml('CreateMongoDBDatabase.template').bind(dict( + database => $.database + )) + - $._environment.reporter.report($this, 'Creating database on MongoDB.') + - $.instance.agent.call($template, $resources) + + # Create user for database + - If: $.username != '' and $.username != null + Then: + - $template: $resources.yaml('CreateUserForMongoDBDatabase.template').bind(dict( + database => $.database, + username => $.username, + password => $.password + )) + - $._environment.reporter.report($this, 'Creating user for database on MongoDB.') + - $.instance.agent.call($template, $resources) + + # Report MongoDB information + - If: $.instance.assignFloatingIp + Then: + - $host: $.instance.floatingIpAddress + Else: + - $host: $.instance.ipAddresses[0] + - $._environment.reporter.report($this, format('MongoDB is available at {0}:{1}.', $host, 27017)) + - $._environment.reporter.report($this, format('MongoDB web admin endpoint is available at http://{0}:{1}.', $host, 28017)) + - $.setAttr(deployed, true) diff --git a/MongoDB/package/LICENSE b/MongoDB/package/LICENSE new file mode 100644 index 00000000..67db8588 --- /dev/null +++ b/MongoDB/package/LICENSE @@ -0,0 +1,175 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. diff --git a/MongoDB/package/Resources/AddFirewallRules.template b/MongoDB/package/Resources/AddFirewallRules.template new file mode 100644 index 00000000..9f59c771 --- /dev/null +++ b/MongoDB/package/Resources/AddFirewallRules.template @@ -0,0 +1,31 @@ +# Licensed under the Apache License, Version 2.0 (the "License"); you may +# not use this file except in compliance with the License. You may obtain +# a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations +# under the License. + +FormatVersion: 2.0.0 +Version: 1.0.0 +Name: Add Firewall Rules + +Parameters: + appName: $appName + +Body: | + return addFirewallRules(args.appName).stdout + +Scripts: + addFirewallRules: + Type: Application + Version: 1.0.0 + EntryPoint: addFirewallRules.sh + Files: [] + Options: + captureStdout: true + captureStderr: true diff --git a/MongoDB/package/Resources/ConfigureMongoDB.template b/MongoDB/package/Resources/ConfigureMongoDB.template new file mode 100644 index 00000000..659a3830 --- /dev/null +++ b/MongoDB/package/Resources/ConfigureMongoDB.template @@ -0,0 +1,31 @@ +# Licensed under the Apache License, Version 2.0 (the "License"); you may +# not use this file except in compliance with the License. You may obtain +# a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations +# under the License. + +FormatVersion: 2.0.0 +Version: 1.0.0 +Name: Configure MongoDB + +Parameters: + appName: $appName + +Body: | + return configureMongoDB(args.appName).stdout + +Scripts: + configureMongoDB: + Type: Application + Version: 1.0.0 + EntryPoint: configureMongoDB.sh + Files: [] + Options: + captureStdout: true + captureStderr: true diff --git a/MongoDB/package/Resources/CreateMongoDBDatabase.template b/MongoDB/package/Resources/CreateMongoDBDatabase.template new file mode 100644 index 00000000..dbc50cc3 --- /dev/null +++ b/MongoDB/package/Resources/CreateMongoDBDatabase.template @@ -0,0 +1,31 @@ +# Licensed under the Apache License, Version 2.0 (the "License"); you may +# not use this file except in compliance with the License. You may obtain +# a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations +# under the License. + +FormatVersion: 2.0.0 +Version: 1.0.0 +Name: Create MongoDB database + +Parameters: + database: $database + +Body: | + return createMongoDBDatabase(args.database).stdout + +Scripts: + createMongoDBDatabase: + Type: Application + Version: 1.0.0 + EntryPoint: createMongoDBDatabase.sh + Files: [] + Options: + captureStdout: true + captureStderr: true diff --git a/MongoDB/package/Resources/CreateUserForMongoDBDatabase.template b/MongoDB/package/Resources/CreateUserForMongoDBDatabase.template new file mode 100644 index 00000000..93440878 --- /dev/null +++ b/MongoDB/package/Resources/CreateUserForMongoDBDatabase.template @@ -0,0 +1,33 @@ +# Licensed under the Apache License, Version 2.0 (the "License"); you may +# not use this file except in compliance with the License. You may obtain +# a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations +# under the License. + +FormatVersion: 2.0.0 +Version: 1.0.0 +Name: Create user for MongoDB database + +Parameters: + database: $database + username: $username + password: $password + +Body: | + return createUserForMongoDBDatabase('{0} {1} {2}'.format(args.database, args.username, args.password)).stdout + +Scripts: + createUserForMongoDBDatabase: + Type: Application + Version: 1.0.0 + EntryPoint: createUserForMongoDBDatabase.sh + Files: [] + Options: + captureStdout: true + captureStderr: true diff --git a/MongoDB/package/Resources/DeployMongoDB.template b/MongoDB/package/Resources/DeployMongoDB.template new file mode 100644 index 00000000..d638b35b --- /dev/null +++ b/MongoDB/package/Resources/DeployMongoDB.template @@ -0,0 +1,31 @@ +# Licensed under the Apache License, Version 2.0 (the "License"); you may +# not use this file except in compliance with the License. You may obtain +# a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations +# under the License. + +FormatVersion: 2.0.0 +Version: 1.0.0 +Name: Deploy MongoDB + +Parameters: + appName: $appName + +Body: | + return deployMongoDB(args.appName).stdout + +Scripts: + deployMongoDB: + Type: Application + Version: 1.0.0 + EntryPoint: deployMongoDB.sh + Files: [] + Options: + captureStdout: true + captureStderr: true diff --git a/MongoDB/package/Resources/scripts/addFirewallRules.sh b/MongoDB/package/Resources/scripts/addFirewallRules.sh new file mode 100644 index 00000000..ac94db8a --- /dev/null +++ b/MongoDB/package/Resources/scripts/addFirewallRules.sh @@ -0,0 +1,15 @@ +#!/bin/bash +# Licensed under the Apache License, Version 2.0 (the "License"); you may +# not use this file except in compliance with the License. You may obtain +# a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations +# under the License. + +sudo iptables -I INPUT 1 -p tcp -m tcp --dport 27017 -j ACCEPT -m comment --comment "by murano, MongoDB service access on port 27017" +sudo iptables -I INPUT 1 -p tcp -m tcp --dport 28017 -j ACCEPT -m comment --comment "by murano, MongoDB httpinterface access on port 28017" diff --git a/MongoDB/package/Resources/scripts/configureMongoDB.sh b/MongoDB/package/Resources/scripts/configureMongoDB.sh new file mode 100644 index 00000000..7d55316b --- /dev/null +++ b/MongoDB/package/Resources/scripts/configureMongoDB.sh @@ -0,0 +1,36 @@ +#!/bin/bash +# Licensed under the Apache License, Version 2.0 (the "License"); you may +# not use this file except in compliance with the License. You may obtain +# a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations +# under the License. + +sudo sed -e "s/^bind_ip*/#bind_ip/" -i /etc/mongodb.conf +sudo service mongodb restart + +# When the MongoDB is launched for the first time, +# it will initialize journal and preallocate the journal files. +# These initializations will be executed in the background. +# The MongoDB service can only be connected by clients +# after these initializations. So this step is trying most 20 times +# to test the connection with the MongoDB service, +# and there is a 30 seconds interval every time. +count=20 + +while [ $count -gt 0 ]; do +sudo mongo <list(), $!=null=>$customJoinNet) + +Forms: + - initDatabaseConfiguration: + fields: + - name: database + type: string + required: false + label: Database name + description: >- + Please provide database name that is going to be created + - name: username + type: string + required: false + label: Username + description: >- + Please provide username that is going to be used to connect to the database + - name: password + type: password + required: false + label: Password + descriptionTitle: Password + description: >- + Please provide password that is going to be used to connect to the database + + - instanceConfiguration: + fields: + - name: title + type: string + required: false + hidden: true + description: Specify some instance parameters on which the application would be created. + - name: flavor + type: flavor + label: Instance flavor + requirements: + min_disk: 8 + min_vcpus: 2 + min_memory_mb: 4096 + description: >- + Select registered in Openstack flavor. Consider that application performance + depends on this parameter. + required: false + - name: osImage + type: image + imageType: linux + label: Instance image + description: >- + Select valid image for the application. Image should already be prepared and + registered in glance. + - name: assignFloatingIP + type: boolean + label: Assign Floating IP + description: >- + Select to true to assign floating IP automatically. + initial: false + required: false + - name: keyPair + type: keypair + label: Key Pair + description: >- + Select the Key Pair to control access to instances. You can login to + instances using this KeyPair after the deployment of application. + required: false + - name: availabilityZone + type: azone + label: Availability zone + description: Select availability zone where application would be installed. + required: false + - name: network + type: network + label: Network + description: Select a network to join. 'Auto' corresponds to a default environment's network. + required: false + murano_networks: translate + - name: unitNamingPattern + type: string + label: Instance Naming Pattern + required: false + maxLength: 64 + regexpValidator: '^[a-zA-z][-_\w]*$' + errorMessages: + invalid: Just letters, numbers, underscores and hyphens are allowed. + helpText: Just letters, numbers, underscores and hyphens are allowed. + description: >- + Specify a string, that will be used in instance hostname. + Just A-Z, a-z, 0-9, dash and underline are allowed. + diff --git a/MongoDB/package/logo.png b/MongoDB/package/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..06ee67b0af390f208fb43b5c974bc365641cd89e GIT binary patch literal 5415 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