UNCLASSIFIED

Skip to content

GitLab

You need to sign in or sign up before continuing.
Commit 2d53ef1d authored by alexander.klepal's avatar alexander.klepal
Browse files

Merge branch 'correction-1.5.3' into 'development' 

Correction 1.5.3

See merge request !3
parents 64d8d739 373d0994
Pipeline #365406 failed with stages
in 28 seconds
Expand all Show whitespace changes
Inline Side-by-side
Showing with 577 additions and 1113 deletions
LICENSE
View file @ 2d53ef1d
# MongoDB Enterprise Advanced (EA) - Customer Agreement # Usage of the MongoDB Enterprise Operator for Kubernetes indicates agreement with the MongoDB Development, Test, and Evaluation Agreement
https://www.mongodb.com/legal/evaluation-agreement
By agreeing to an Order Form that references this Customer Agreement (this “Agreement”), or by downloading our Software for a free trial, you agree to this Agreement. If you represent an organization, you represent and warrant that you have the authority to agree to this Agreement on behalf of your organization.
1. Definitions. The following terms have the following meanings:
“Affiliate” means an organization that controls, is controlled by, or is under common control with, a party, where “control” means direct or indirect ownership of more than 50% of the voting interests of the organization.
“Confidential Information” means information a party designates as confidential or reasonably considers as confidential, and includes pricing information on an Order Form. “Confidential Information” excludes information that is (a) or becomes publicly available through no fault of the recipient, (b) received from a third party without a duty of confidentiality, (c) independently developed by the receiving party without breaching this Agreement, or (d) rightfully known or lawfully in the possession of the receiving party prior to disclosure from the other party.
“Consulting Services” means the consulting or professional services included in your Subscription.
“Customer,” “you” and “your” means the organization that agrees to an Order Form or downloads the Software for a free trial.
“Deliverable” means a work provided to you as a part of the Consulting Services, including any report.
“Documentation” means the instructions, specifications and information regarding the Software available at https://docs.mongodb.com/.
“MongoDB,” “we,” “our” and “us” means the MongoDB company that agrees to an Order Form.
“Order Form” means an ordering document for Subscriptions signed by both parties that refers to this Agreement.
“Server” means each unit of RAM as specified on an Order Form of: (a) a physical machine, dedicated server or server blade that stores data; or (b) an instance that stores data in a public or private cloud, where “cloud” includes any type of virtualized or containerized environment (e.g., simple operating systems, virtual machines, CGroups).
“Software” means the MongoDB Enterprise database software, MongoDB Ops Manager, MongoDB Charts, MongoDB Connector for Business Intelligence, and any other software included with a Subscription, including any generally available updates to such software, but excluding open source software components, each of which has its copyright notice and license included in the license file and Documentation.
“Subscription” means a subscription for our Software, Support, or Consulting Services set forth in an Order Form.
“Support” means support, if any, included in a Subscription.
2. Subscriptions.
(a) Generally. We will provide you with the Software, Support and Consulting Services included in the Subscription. We will provide you with Support in accordance with the applicable support policy available on our website, currently available at https://www.mongodb.com/support-policy. While we may modify our support policy from time to time, we will not modify it in a way that materially and adversely affects your Support. Your Affiliates may purchase Subscriptions directly from us by signing an Order Form and you may allow an Affiliate to use your Subscriptions as long as you are responsible for the Affiliate’s compliance with this Agreement.
(b) Free Evaluation and Development. MongoDB grants you a royalty-free, nontransferable and nonexclusive license to use and reproduce the Software in your internal environment for evaluation and development purposes. You will not use the Software for any other purpose, including testing, quality assurance or production purposes without purchasing an Enterprise Advanced Subscription. We provide the free evaluation and development license of our Software on an “AS-IS” basis without any warranty.
(c) Enterprise Advanced Subscription. MongoDB grants you a nontransferable and nonexclusive license during the term of the Subscription to use and reproduce the Software in your internal environment for the purposes and on the number of Servers stated on the Order Form. You will cover each Server used by an application with an Enterprise Advanced Subscription.
3. Consulting Services. You will provide MongoDB with reasonable assistance and information to facilitate scheduling and performance of Consulting Services. You will also appoint an engagement manager to help ensure effective delivery of the Consulting Services. Consulting Services and any Deliverables are accepted when delivered unless otherwise set forth in an Order Form. We may engage qualified subcontractors to provide the Consulting Services, and we are responsible for any subcontractor’s compliance with this Agreement. We grant you a royalty-free, perpetual, nontransferable and nonexclusive license to use and reproduce any Deliverables for your internal business purposes, except for training materials, which may only be used by the individual employees who attended the training session.
4. Your Responsibilities. As a condition to your use of the Software, you will not, and will not allow any third party to: (a) decompile, disassemble, translate, reverse engineer or attempt to derive source code from any portion of the Software; (b) sell, sublicense, rent, lease, distribute, market, or commercialize the Software, your Subscription or any Deliverables, provided that you may use the Software in connection with an application available to your end customers as long as they cannot access the Software directly; (c) directly or indirectly circumvent or violate the technical restrictions of the Software; (d) remove any identification, proprietary, copyright or other notices in the Software, Documentation or Deliverables; (e) modify or create a derivative work of any portion of the Software; (f) publicly disseminate performance information about, or analysis of, the Software, including benchmarking test results, or your Subscription; (g) use the Software on more Servers than licensed on an Order Form; (h) use Support or Ops Manager, Cloud Manager, MongoDB Charts, or MongoDB Connector for Business Intelligence in connection with any application that is not covered by an Enterprise Advanced Subscription; or (i) access or use the Software in a way intended to avoid incurring fees or exceeding usage limits or quotas. You will comply with applicable laws in connection with your use of Software, Deliverables, Consulting Services and your Subscriptions, including any applicable U.S. export regulations and anti-corruption laws.
5. Payment and Taxes. You will pay undisputed fees and reimburse any business expenses as set forth on and in accordance with an Order Form. Your payment for Subscriptions is non-refundable and you may not terminate or cancel an Order Form except as stated in this Agreement. Our fees exclude and you will pay applicable taxes and similar charges, including sales, usage, excise and value added taxes. Nothing in this Agreement requires either party to pay any income taxes or similar charges of the other party. If applicable law requires you to withhold any amount from your payment, you will provide us with copies of documents related to your withholding upon our request.
6. Confidentiality. This Agreement supersedes any applicable non-disclosure agreement between the parties with respect to your use of the Software. The receiving party will use the disclosing party’s Confidential Information only in connection with this Agreement and protect the disclosing party’s Confidential Information by using the same degree of care used to protect its own confidential information, but not less than a reasonable degree of care. The receiving party will limit disclosure of the disclosing party’s Confidential Information to its and its Affiliates’ directors, officers, employees and contractors bound to confidentiality obligations at least as protective as the confidentiality provisions in this Agreement and who have a need to know the Confidential Information. The receiving party will not disclose the disclosing party’s Confidential Information to a any other third party without the disclosing party's consent, except where required to comply with applicable law or a compulsory legal order or process, provided that the receiving party will, if legally permitted, promptly notify the disclosing party. Each party will return or destroy the other party’s Confidential Information upon written request from the other party.
7. Intellectual Property. This Agreement does not transfer any right, title or interest in any intellectual property to any party, except as expressly set forth in this Agreement. You are not obligated to provide us with any suggestions or other feedback, but if you do, we may use and modify this feedback without any restriction or payment.
8. Warranties. MongoDB represents and warrants that: (a) the Software will perform substantially in accordance with the Documentation, and (b) it will perform Consulting Services and Support in a diligent and workmanlike manner consistent with industry standards. Your exclusive remedy for MongoDB’s material breach of warranty is to terminate any affected Subscription in accordance with Section 11 and receive a refund of any prepaid fees for unused Subscriptions. Except as set forth in this Section, we provide the Software, Consulting Services and Support on an “AS-IS” basis. To the fullest extent not prohibited by law, MongoDB disclaims and this Agreement excludes any implied or statutory warranty, including any warranty of title, non-infringement, merchantability or fitness for a particular purpose.
9. Limitation of Liability.
(a) Neither party will be liable to the other for any incidental or consequential damages, including lost profits or business opportunities, or any special or punitive damages.
(b) Except as set forth in Section 9(c) and 9(d), each party’s cumulative liability will not exceed the total fees payable to MongoDB by Customer under this Agreement during the 12-month period before the event giving rise to the liability.
(c) Each party’s cumulative liability under Section 10 will not exceed $3,000,000.
(d) Nothing in this Agreement limits either party’s liability for: (i) fraud or fraudulent misrepresentation; (ii) death or personal injury caused by negligence, gross negligence or intentional misconduct; (iii) Customer’s payment obligations; or (iv) any liability which cannot legally be limited.
10. Indemnification.
(a) Customer Indemnification. If a third party asserts a claim against MongoDB alleging that software, content or data used by Customer in connection with the Software or any Subscription, or provided to MongoDB in order for MongoDB to perform Consulting Services, infringes a third party’s intellectual property right (a “Claim Against Us”), Customer will defend MongoDB against the Claim Against Us at Customer’s expense, and indemnify MongoDB from any damages, reasonable legal fees and costs finally awarded against MongoDB to the extent resulting from the Claim Against Us or for amounts paid by MongoDB to settle the Claim Against Us. Customer will have no obligation to defend or indemnify MongoDB if the Claim Against Us is based on MongoDB’s unauthorized changes to Customer’s software, content, data or other information.
(b) MongoDB Indemnification. If a third party asserts a claim against Customer that the Software infringes a third party’s intellectual property right or any Deliverable infringes a third party’s copyright (a “Claim Against You”), MongoDB will defend Customer against the Claim Against You at MongoDB’s expense and indemnify Customer from any damages, reasonable legal fees and costs finally awarded against Customer to the extent resulting from the Claim Against You or for amounts paid by Customer to settle the Claim Against You. MongoDB will not be obligated to defend or indemnify Customer if the Claim Against You is based on: (i) combination of the Software with other software, content, data or business process not contemplated by Documentation; (ii) use of any older release of the Software when use of a newer version would have avoided the alleged or actual infringement; (iii) any modification of the Software made by anyone other than MongoDB; or (iv) MongoDB's compliance with any materials, designs, specifications or instructions provided by Customer.
(c) Infringement Remedies. In addition to MongoDB’s indemnity obligations, if the Software or any Deliverable becomes, or in MongoDB’s opinion is likely to become, the subject of an infringement claim, MongoDB may at its option and expense and as Customer’s sole and exclusive remedy: (i) procure for Customer the right to make continued use of the Software or Deliverable; (ii) replace or modify the Software or Deliverable so that it becomes non-infringing; or (iii) terminate Customer’s license to the Software or Deliverable and refund any prepaid fees for unused Subscriptions.
(d) Indemnification Procedures. Each party will provide the other with prompt notice of any claim. A party’s failure to provide prompt notice to the other party relieves the party of its obligation to defend and indemnify the other party only to the extent that the failure to provide notice materially harms the party’s ability to defend the claim. The indemnifying party will have sole control of the defense of the claim, including any settlement. The indemnified party will provide the indemnifying party with reasonable cooperation in connection with the defense of the claim, and may participate in the defense at its own expense. This Section 10 sets forth each party’s exclusive remedy for any third party infringement claim.
11. Term and Termination. The term of this Agreement commences when you agree to an Order Form, or you download our Software for a free trial, and will remain in effect until terminated in accordance with this Agreement. Either party may terminate this Agreement for convenience immediately upon notice if all Order Forms under this Agreement have expired or been terminated. Neither party may terminate an Order Form for convenience. If a party fails to cure a material breach of this Agreement within 30 days after receipt of written notice of the breach, the other party may terminate this Agreement and any affected Order Form. Upon termination of an Order Form or this Agreement, you will remove the Software from all Servers covered by the terminated Subscriptions. Provisions intended by their nature to survive termination of this Agreement survive termination. During the term of this Agreement and one year following termination, we may inspect your records relating to your use of the Software or Consulting Services for the purposes of verifying compliance with this Agreement.
12. General. Notices under this Agreement will be in writing and effective on the delivery date. The parties will deliver notices by personal delivery or courier to the address of the other party set forth on the Order Form. If you are located in North, Central or South America, New York law governs this Agreement, excluding any applicable conflict of laws rules or principles, and the parties agree to the exclusive jurisdiction of the courts in New York, New York. For customers located elsewhere, the law of England and Wales governs this Agreement, excluding any applicable conflict of laws rules or principles, and the parties agree to the exclusive jurisdiction of the courts in London, England. This Agreement does not create a partnership, agency relationship, or joint venture between the parties. The United Nations Convention for the International Sale of Goods does not apply to this Agreement. Unless you tell us otherwise in writing, we may refer to our relationship with you as a customer. Any assignment of this Agreement by you without our prior written consent will be null and void, except an assignment to an Affiliate or in connection with a merger or sale of all or substantially all of your assets or stock, provided that you may not assign this Agreement to a competitor of ours without our prior written consent. If any provision of this Agreement is unenforceable, that provision will be modified to render it enforceable to the extent possible to effect the parties’ intention and the remaining provisions will not be affected. The parties may amend this Agreement only by a written amendment signed by both parties. This Agreement incorporates any addenda or exhibits, and any Order Form, and comprises the parties’ entire agreement relating to the subject matter of this Agreement. Neither party has entered into this Agreement in reliance on any representations or warranties other than those expressly set forth in this Agreement or in an applicable Order Form. If any conflict exists between the provisions in this Agreement and any Order Form, the Order Form controls, and if any conflict exists between this Agreement and any addenda, exhibit or other agreement, this Agreement controls. A purchase order is for convenience only and any terms that govern the purchase order are of no effect. Customer’s purchase of any Subscription is not contingent on, and Customer has not relied on, the delivery of any future functionality, regardless of any communication about our products. Neither party will be liable for failures or delays in performance due to causes beyond its reasonable control.
README.md
View file @ 2d53ef1d
# Before You Begin # # Before You Begin #
**PRIOR TO UTILIZING THE MONGODB ENTERPRISE ADVANCED CONTAINER, CONTACT YOUR MONGODB SALES REPRESENTATIVE.** YOUR USE OF THE MONGODB ENTERPRISE SERVER IS SUBJECT TO THE TERMS AND CONDITIONS OF THE AGREEMENT BETWEEN USAF AND THE APPLICABLE RESELLER OF THE MONGODB ENTERPRISE SERVER. SUCH AGREEMENT INCORPORATES THE TERMS & CONDITIONS OF THE MONGODB ENTERPRISE ADVANCED LICENSE AGREEMENT, THE VERSION OF WHICH CURRENT AS OF SEPTEMBER 2020 IS SET FORTH BELOW. THE MONGODB ENTERPRISE ADVANCED LICENSE AGREEMENT IS SUBJECT TO AMENDMENT AND MODIFICATION FROM TIME TO TIME. **PRIOR TO UTILIZING THESE MONGODB ENTERPRISE ADVANCED CONTAINERS, CONTACT YOUR MONGODB SALES REPRESENTATIVE.** YOUR USE OF THE MONGODB ENTERPRISE SERVER IS SUBJECT TO THE TERMS AND CONDITIONS OF THE AGREEMENT BETWEEN USAF AND THE APPLICABLE RESELLER OF THE MONGODB ENTERPRISE SERVER. SUCH AGREEMENT INCORPORATES THE TERMS & CONDITIONS OF THE MONGODB ENTERPRISE ADVANCED LICENSE AGREEMENT, THE VERSION OF WHICH CURRENT AS OF SEPTEMBER 2020 IS SET FORTH BELOW. THE MONGODB ENTERPRISE ADVANCED LICENSE AGREEMENT IS SUBJECT TO AMENDMENT AND MODIFICATION FROM TIME TO TIME.
# Contact Information # # Contact Information #
For licensing and technical information, please use the following contact information: For licensing and technical information, please use the following contact information:
Anton Hoffman, EAE USAF Keegan Wetzel, EAE USAF
781-996-8860 708-256-7904
anton.hoffman@mongodb.com keegan.wetzel@mongodb.com
Please also CC: publicsector@mongodb.com Please also CC: publicsector@mongodb.com
# Platform One #
Note that the majority of this specific repo ("MongoDB Enterprise Kubernetes") is a clone of the public 1.5.3 repo. It contains essential files, such as the crd.yaml file, which must be deployed prior to deployment of the MongoDB Kubernetes Operator. Additional files have been provided that are specific to Platform One. Look in the platform_one folder for a mongodb-enterprise.yaml file configured to use the Platform One containers, as well as an example Ops Manager configuration file that is configured for Local Mode operation (i.e. disconnected environments).
# MongoDB Enterprise Kubernetes Operator # # MongoDB Enterprise Kubernetes Operator #
...@@ -24,7 +27,7 @@ The Operator requires access to one of our database management tools - Ops Manag ...@@ -24,7 +27,7 @@ The Operator requires access to one of our database management tools - Ops Manag
You may run Ops Manager either inside or outside Kubernetes, or may use Cloud Manager (cloud.mongodb.com) instead. You may run Ops Manager either inside or outside Kubernetes, or may use Cloud Manager (cloud.mongodb.com) instead.
The Operator is currently Generally Available, supported by the [MongoDB Support Team](https://support.mongodb.com/). If you need urgent help, please file a support ticket. The Operator is currently Generally Available, supported by the [MongoDB Support Team](https://support.mongodb.com/). If you need urgent help, please file a support ticket.
For non-urgent requests, you may file a Github Issue in the public repo (https://github.com/mongodb/mongodb-enterprise-kubernetes). For non-urgent requests, you may file a Github Issue here in the repo.
You can discuss this integration in our new [Community Forum](https://community.mongodb.com/) - please use the tag [enterprise-kubernetes-operator](https://community.mongodb.com/tags/enterprise-kubernetes-operator). You can discuss this integration in our new [Community Forum](https://community.mongodb.com/) - please use the tag [enterprise-kubernetes-operator](https://community.mongodb.com/tags/enterprise-kubernetes-operator).
...@@ -51,7 +54,8 @@ to see which Kubernetes and Openshift versions the Operator is compatible with ...@@ -51,7 +54,8 @@ to see which Kubernetes and Openshift versions the Operator is compatible with
To work with MongoDB resource this Operator requires [Ops Manager](https://docs.opsmanager.mongodb.com/current/) (Ops Manager can To work with MongoDB resource this Operator requires [Ops Manager](https://docs.opsmanager.mongodb.com/current/) (Ops Manager can
be installed into the same Kubernetes cluster by the Operator or installed outside of the cluster manually) be installed into the same Kubernetes cluster by the Operator or installed outside of the cluster manually)
or [Cloud Manager](https://cloud.mongodb.com/user#/cloud/login).
> If this is your first time trying the Operator, Cloud Manager is easier to get started
## Installation ## Installation
...@@ -112,7 +116,7 @@ Check the end of the page for instructions on how to remove the Operator. ...@@ -112,7 +116,7 @@ Check the end of the page for instructions on how to remove the Operator.
For the Operator to work, you will need the following information: For the Operator to work, you will need the following information:
* Base URL - the URL of an Ops Manager instance * Base URL - the URL of an Ops Manager instance (for Cloud Manager use `https://cloud.mongodb.com`)
* (optionally) Project Name - the name of an Ops Manager Project where MongoDBs will be deployed into. It will be * (optionally) Project Name - the name of an Ops Manager Project where MongoDBs will be deployed into. It will be
created by the Operator if it doesn't exist (and this is the recommended way instead of reusing the project created created by the Operator if it doesn't exist (and this is the recommended way instead of reusing the project created
in OpsManager directly). If omitted the name of the MongoDB resource will be used as a project name. in OpsManager directly). If omitted the name of the MongoDB resource will be used as a project name.
......
crds.yaml
View file @ 2d53ef1d
---
# Source: mongodb-enterprise-operator/templates/crds.yaml
--- ---
apiVersion: apiextensions.k8s.io/v1beta1 apiVersion: apiextensions.k8s.io/v1beta1
kind: CustomResourceDefinition kind: CustomResourceDefinition
...@@ -90,14 +93,19 @@ spec: ...@@ -90,14 +93,19 @@ spec:
additionalMongodConfig: additionalMongodConfig:
type: object type: object
exposedExternally: properties:
type: boolean net:
agent:
type: object type: object
properties: properties:
startupOptions: ssl:
type: object type: object
properties:
mode:
type: string
enum: ["disabled", "allowSSL", "preferSSL", "requireSSL", "allowTLS", "preferTLS", "requireTLS"]
exposedExternally:
type: boolean
# Generic PodSpec configuration # Generic PodSpec configuration
podSpec: podSpec:
...@@ -174,41 +182,15 @@ spec: ...@@ -174,41 +182,15 @@ spec:
authentication: authentication:
type: object type: object
properties: properties:
agents:
type: object
properties:
mode:
type: string
enum: ["SCRAM", "X509", "LDAP"]
automationUsername:
type: string
automationPasswordSecretRef:
type: object
properties:
name:
type: string
key:
type: string
automationLdapGroupDN:
type: string
clientCertificateSecretRef:
type: object
properties:
name:
type: string
required:
- mode
enabled: enabled:
type: boolean type: boolean
modes: modes:
type: array type: array
items: items:
type: string type: string
enum: ["SCRAM", "X509", "LDAP"] enum: ["SCRAM", "X509"]
ignoreUnknownUsers: ignoreUnknownUsers:
type: boolean type: boolean
requireClientTLSAuthentication:
type: boolean
tls: tls:
type: object type: object
properties: properties:
...@@ -216,104 +198,11 @@ spec: ...@@ -216,104 +198,11 @@ spec:
type: boolean type: boolean
ca: ca:
type: string type: string
secretRef:
type: object
properties:
name:
type: string
additionalCertificateDomains: additionalCertificateDomains:
type: array type: array
items: items:
type: string type: string
ldap:
type: object
properties:
bindQueryUser:
type: string
servers:
type: array
items:
type: string
transportSecurity:
type: string
enum: ["none", "tls"]
bindQueryPasswordSecretRef:
type: object
properties:
name:
type: string
caConfigMapRef:
type: object
authzQueryTemplate:
type: string
userToDNMapping:
type: string
roles:
type: array
description: "List of roles not bounded to specific users"
items:
type: object
properties:
role:
type: string
description: "The name of the role"
db:
type: string
description: "The db the role belongs to"
roles:
type: array
description: "List of roles this role inherits from"
items:
type: object
properties:
db:
type: string
description: "The db the role belongs to"
role:
type: string
description: "The name of the role"
authenticationRestrictions:
type: array
description: "List of restriction for users authenticating to this role"
items:
type: object
properties:
clientSource:
type: array
description: "List of IP addresses or CIDR ranges allowed the user can connect from"
items:
type: string
serverAddress:
type: array
description: "List of IP addresses or CIDR ranges allowed the user can connect to"
items:
type: string
privileges:
type: array
description: "List of privileges granted to this role"
items:
type: object
properties:
actions:
type: array
description: "List of actions allowed to this role"
items:
type: string
resource:
type: object
description: "Resource on which the privileges are granted"
properties:
db:
type: string
description: "Name of the database"
collection:
type: string
description: "Name of the collection"
cluster:
type: boolean
description: "True for cluster-wide privileges"
# Sharded Cluster properties # Sharded Cluster properties
shardPodSpec: shardPodSpec:
type: object type: object
...@@ -514,10 +403,8 @@ spec: ...@@ -514,10 +403,8 @@ spec:
labelSelector: labelSelector:
type: object type: object
configServerCount: configServerCount:
minimum: 1
type: integer type: integer
mongodsPerShardCount: mongodsPerShardCount:
minimum: 1
type: integer type: integer
mongosCount: mongosCount:
minimum: 1 minimum: 1
...@@ -525,36 +412,7 @@ spec: ...@@ -525,36 +412,7 @@ spec:
shardCount: shardCount:
minimum: 1 minimum: 1
type: integer type: integer
mongos:
type: object
properties:
additionalMongodConfig:
type: object
agent:
type: object
properties:
startupOptions:
type: object
configSrv:
type: object
properties:
additionalMongodConfig:
type: object
agent:
type: object
properties:
startupOptions:
type: object
shard:
type: object
properties:
additionalMongodConfig:
type: object
agent:
type: object
properties:
startupOptions:
type: object
--- ---
apiVersion: apiextensions.k8s.io/v1beta1 apiVersion: apiextensions.k8s.io/v1beta1
kind: CustomResourceDefinition kind: CustomResourceDefinition
...@@ -635,6 +493,7 @@ spec: ...@@ -635,6 +493,7 @@ spec:
required: required:
- username - username
- db - db
--- ---
apiVersion: apiextensions.k8s.io/v1beta1 apiVersion: apiextensions.k8s.io/v1beta1
kind: CustomResourceDefinition kind: CustomResourceDefinition
...@@ -707,8 +566,6 @@ spec: ...@@ -707,8 +566,6 @@ spec:
tls: tls:
type: object type: object
properties: properties:
ca:
type: string
secretRef: secretRef:
type: object type: object
properties: properties:
...@@ -841,8 +698,7 @@ spec: ...@@ -841,8 +698,7 @@ spec:
s3SecretRef: s3SecretRef:
type: object type: object
properties: properties:
name: name: string
type: string
required: required:
- name - name
- pathStyleAccessEnabled - pathStyleAccessEnabled
...@@ -902,13 +758,6 @@ spec: ...@@ -902,13 +758,6 @@ spec:
properties: properties:
spec: spec:
type: object type: object
agent:
type: object
properties:
startupOptions:
type: object
podSpec: podSpec:
type: object type: object
properties: properties:
...@@ -980,13 +829,18 @@ spec: ...@@ -980,13 +829,18 @@ spec:
required: required:
- version - version
- applicationDatabase - applicationDatabase
# This ClusterRole is necessary in order to use validating webhooks—these will
# prevent you from applying a variety of invalid resource definitions. The
# validating webhooks are optional so this can be removed if necessary.
--- ---
kind: ClusterRole kind: ClusterRole
apiVersion: rbac.authorization.k8s.io/v1 apiVersion: rbac.authorization.k8s.io/v1
metadata: metadata:
name: mongodb-enterprise-operator-mongodb-webhook name: mongodb-enterprise-operator-mongodb-webhook
rules: rules:
- apiGroups: - apiGroups:
- "admissionregistration.k8s.io" - "admissionregistration.k8s.io"
resources: resources:
- validatingwebhookconfigurations - validatingwebhookconfigurations
......
docs/openshift-marketplace.md deleted 100644 → 0
View file @ 64d8d739
# OpenShift MongoDB Enterprise Kubernetes Operator
## Operator Service Catalog and Marketplace
This installation document is a guide for deploying MongoDB Enterprise Kubernetes Operator, Ops Manager and first MongoDB DataBase using OpenShift Operator catalog or Marketplace.
## Configuring required components
Step 1: Create a namespace to install MongoDB
```
oc create ns mongodb
```
Step 2: Install the operator in the cluster in the namespace created above
![Installed Operators](assets/image--000.png)
Step 3: Wait for the Operator to be deployed.
![Operator Installed](assets/image--002.png)
Step 4: Deploy MongoDB Ops Manager.
Ops Manager is an Enterprise Control Plane for all your MongoDB Clusters. It is a extensive application and may seem complicated. Please visit [Documentation](https://docs.mongodb.com/kubernetes-operator/stable/om-resources/) to plan and configure production deployments.
*Only a single Ops Manager deployment is required for all MongoDB clusters in your organization. This step could be skipped if Ops Manager is already deployed. Alternatively [Cloud Manager](https://cloud.mongodb.com) - hosted Ops Manager could be used instead.*
![Screenshot](assets/image--004.png)
To deploy a very simple Ops Manager configuration two steps are required.
1. Create Admin Credential Secret
```bash
create secret generic ops-manager-admin-secret \
--from-literal=Username="jane.doe@example.com" \
--from-literal=Password="Passw0rd." \
--from-literal=FirstName="Jane" \
--from-literal=LastName="Doe" -n mongodb
```
2. Deploy Ops Manager instance with CRD
![Screenshot](assets/image--008.png)
With sample yaml CRD definition
```yaml
apiVersion: mongodb.com/v1
kind: MongoDBOpsManager
metadata:
name: ops-manager
namespace: mongodb
spec:
# the version of Ops Manager to use
version: 4.4.1
# the name of the secret containing admin user credentials.
adminCredentials: ops-manager-admin-secret
externalConnectivity:
type: LoadBalancer
# the Replica Set backing Ops Manager.
# appDB has the SCRAM-SHA authentication mode always enabled
applicationDatabase:
members: 3
```
Change the `adminCredentials` property to link to the name of the secret created previously. In this example it is ops-manager-admin.
`Click create.`
>For more detailed installation visit our blog post: https://www.mongodb.com/blog/post/running-mongodb-ops-manager-in-kubernetes
Step 7: Verify MongoDB Ops Manager is successfully deployed. Verify Ops Manager resource and ensure that ops-manager resource reached Running state :
`oc describe om ops-manager`
>NOTE: Wait for the secret ops-manager-admin-key to be created. It contains Global Admin Programmatic API that will be required in the subsequent steps. We recommend to create new Programmatic API Key scoped to a single Ops Manager Organization https://docs.opsmanager.mongodb.com/rapid/tutorial/manage-programmatic-api-keys/#mms-prog-api-key
Please note OpsManager URL exposed by LoadBalancer before moving to the next Section
## Deploy MongoDB
In order to create MongoDB Cluster three Kubernetes resources need to be deployed. https://docs.mongodb.com/kubernetes-operator/stable/mdb-resources/
1. Kubernetes ConfigMap that contain settings for Operator to connect to Ops Manager
```bash
os create configmap <configmap-name> \
--from-literal="baseUrl=<OpsManagerURL>" \
--from-literal="projectName=<myOpsManagerProjectName>" \ #Optional
--from-literal="orgId=<Ops Manager OrgID>"
```
>OpsManagerURL is an Ops Manager url including port (default 8080) noted in Step 7.
>Documentation: https://docs.mongodb.com/kubernetes-operator/stable/tutorial/create-project-using-configmap/#create-k8s-project
2. Kubernetes Secret containing Programmatic API Key to Operator to connect to Ops Manager.
> ops-manager-admin-key secret could be used instead for none production deployments.
```
oc -n <metadata.namespace> \
create secret generic <myCredentials> \
--from-literal="user=<publicKey>" \
--from-literal="publicApiKey=<privateKey>"
```
For instructions on how to create Ops Manager Organization and Programmatic API Key please refer to documentation: https://docs.mongodb.com/kubernetes-operator/stable/tutorial/create-operator-credentials/#create-k8s-credentials
3. Deploy Ops Manager
![Deploy MongoDB](assets/image--030.png)
Click on the first tile to create the MongoDB Deployment Instance
![Deploy MongoDB](assets/image--032.png)
* Choose a name for MongoDB cluster 'metadata.name`
* Substitute the values `spec.OpsManager` with a reference to the config map `<configmap-name>`
* Substitute the values `spec.credentials` with secret name `<myCredentials>`.
`Click Create. `
>For comprehensive Documentation, please visit https://docs.mongodb.com/kubernetes-operator/stable/mdb-resources/
### Verify MongoDB cluster is operational
Verify Status of MongoDB Resource reached ``Running`` state
>Optionally monitor state of pods, sts and services linked to MongoDB CRD
![Deploy MongoDB](assets/image--034.png)
>Note: MongoDB Enterprise Operator logs are the best source to start troubleshooting any issues with deployments
### Connect to MongoDB Cluster
MongoDB Enterprise Operator create Kubernetes Service For each MongoDB deployed using default port 27017.
` <mongodb-service-name>.<k8s-namespace>.svc.<cluster-name>`
MongoDB Connection String could be built using SRV record
` mongodb+srv://<mongodb-service-name>.<k8s-namespace>.svc.<cluster-name>`
***In order to connect to MongoDB from outside of OpenShift cluster an ingress route needs to be created manually. Operator does not create ingress or external services.***
***MongoDB ReplicaSet External connectivity requires Split Horizon Configuration: [Connect to a MongoDB Database Resource from Outside Kubernetes](https://docs.mongodb.com/kubernetes-operator/stable/tutorial/connect-from-outside-k8s/)***
>EXAMPLE
To connect to a sharded cluster resource named shardedcluster, you might use the following connection string: <br/> ``mongo --host shardedcluster-mongos-0.shardedcluster-svc.mongodb.svc.cluster.local --port 27017``
helm_chart/Chart.yaml
View file @ 2d53ef1d
name: mongodb-enterprise-operator name: mongodb-enterprise-operator
description: MongoDB Kubernetes Enterprise Operator description: MongoDB Kubernetes Enterprise Operator
version: 1.8.0 version: 1.5.3
kubeVersion: '>=1.13-0' kubeVersion: '>=1.13'
keywords: keywords:
- mongodb - mongodb
- database - database
......
helm_chart/crds/mongodbusers.mongodb.com.yaml deleted 100644 → 0
View file @ 64d8d739
---
apiVersion: apiextensions.k8s.io/v1beta1
kind: CustomResourceDefinition
metadata:
name: mongodbusers.mongodb.com
spec:
group: mongodb.com
version: v1
scope: Namespaced
names:
kind: MongoDBUser
plural: mongodbusers
shortNames:
- mdbu
singular: mongodbuser
additionalPrinterColumns:
- name: State
type: string
description: The current state of the MongoDB User
JSONPath: .status.phase
- name: Age
type: date
description: The time since the MongoDB User resource was created
JSONPath: .metadata.creationTimestamp
subresources:
status: {}
validation:
openAPIV3Schema:
type: object
properties:
spec:
type: object
properties:
username:
type: string
description: "The username of the user"
db:
type: string
description: "The database the user is stored in"
project:
type: string
description: "The project the user belongs to"
passwordSecretKeyRef:
type: object
properties:
name:
type: string
key:
type: string
description: "DEPRECATED The project the user belongs to"
mongodbResourceRef:
type: object
properties:
name:
type: string
description: "The name of a MongoDB resource in the same namespace"
roles:
type: array
items:
type: object
properties:
name:
type: string
description: "The name of the role"
db:
type: string
description: "The db the role can act on"
passwordSecretKeyRef:
type: object
properties:
name:
type: string
key:
type: string
required:
- name
- db
required:
- username
- db
helm_chart/crds/opsmanagers.mongodb.com.yaml deleted 100644 → 0
View file @ 64d8d739
---
apiVersion: apiextensions.k8s.io/v1beta1
kind: CustomResourceDefinition
metadata:
name: opsmanagers.mongodb.com
spec:
group: mongodb.com
version: v1
scope: Namespaced
names:
kind: MongoDBOpsManager
plural: opsmanagers
shortNames:
- om
singular: opsmanager
additionalPrinterColumns:
- name: Replicas
type: integer
description: The number of replicas of MongoDBOpsManager.
JSONPath: .spec.replicas
- name: Version
type: string
description: The version of MongoDBOpsManager.
JSONPath: .spec.version
- name: State (OpsManager)
type: string
description: The current state of the MongoDBOpsManager.
JSONPath: .status.opsManager.phase
- name: State (AppDB)
type: string
description: The current state of the MongoDBOpsManager Application Database.
JSONPath: .status.applicationDatabase.phase
- name: State (Backup)
type: string
description: The current state of the MongoDBOpsManager Backup Daemon.
JSONPath: .status.backup.phase
- name: Age
type: date
description: The time since the MongoDBOpsManager resource was created.
JSONPath: .metadata.creationTimestamp
- name: Warnings
type: string
description: Warnings
JSONPath: .status.warnings
subresources:
status: {}
validation:
openAPIV3Schema:
type: object
properties:
spec:
type: object
properties:
version:
type: string
replicas:
minimum: 1
type: integer
clusterName:
type: string
format: hostname
description: "DEPRECATED Use clusterDomain instead"
clusterDomain:
type: string
format: hostname
security:
type: object
properties:
tls:
type: object
properties:
ca:
type: string
secretRef:
type: object
properties:
name:
type: string
required:
- name
adminCredentials:
type: string
externalConnectivity:
type: object
properties:
type:
type: string
enum: ["LoadBalancer", "NodePort"]
port:
type: integer
loadBalancerIP:
type: string
externalTrafficPolicy:
type: string
enum: ["Cluster", "Local"]
annotations:
type: object
required:
- type
configuration:
type: object
jvmParameters:
type: array
items:
type: string
statefulSet:
type: object
properties:
spec:
type: object
backup:
type: object
properties:
enabled:
type: boolean
jvmParameters:
type: array
items:
type: string
headDB:
type: object
properties:
storage:
type: string
storageClass:
type: string
opLogStores:
type: array
items:
type: object
properties:
name:
type: string
mongodbResourceRef:
type: object
properties:
name:
type: string
required:
- name
mongodbUserRef:
type: object
properties:
name:
type: string
required:
- name
required:
- name
- mongodbResourceRef
blockStores:
type: array
items:
type: object
properties:
name:
type: string
mongodbResourceRef:
type: object
properties:
name:
type: string
required:
- name
mongodbUserRef:
type: object
properties:
name:
type: string
required:
- name
required:
- name
- mongodbResourceRef
s3Stores:
type: array
items:
type: object
properties:
name:
type: string
mongodbResourceRef:
type: object
properties:
name:
type: string
required:
- name
mongodbUserRef:
type: object
properties:
name:
type: string
required:
- name
pathStyleAccessEnabled:
type: boolean
s3BucketEndpoint:
type: string
s3BucketName:
type: string
s3SecretRef:
type: object
properties:
name:
type: string
required:
- name
- pathStyleAccessEnabled
- s3BucketEndpoint
- s3BucketName
- s3SecretRef
statefulSet:
type: object
properties:
spec:
type: object
required:
- enabled
applicationDatabase:
type: object
properties:
passwordSecretKeyRef:
type: object
properties:
name:
type: string
key:
type: string
required:
- name
security:
type: object
properties:
tls:
type: object
properties:
ca:
type: string
secretRef:
type: object
properties:
name:
type: string
required:
- name
required:
- secretRef
members:
maximum: 50
minimum: 3
type: integer
version:
type: string
pattern: "^[0-9]+.[0-9]+.[0-9]+(-.+)?$|^$"
logLevel:
type: string
enum: ["DEBUG", "INFO", "WARN", "ERROR", "FATAL"]
persistent:
type: boolean
statefulSet:
type: object
properties:
spec:
type: object
agent:
type: object
properties:
startupOptions:
type: object
podSpec:
type: object
properties:
podTemplate:
type: object
properties:
metadata:
type: object
spec:
type: object
podAntiAffinityTopologyKey:
type: string
cpu:
type: string
cpuRequests:
type: string
memory:
type: string
memoryRequests:
type: string
podAffinity:
type: object
nodeAffinity:
type: object
persistence:
type: object
properties:
single:
type: object
properties:
storage:
type: string
storageClass:
type: string
labelSelector:
type: object
multiple:
type: object
properties:
data:
type: object
properties:
storage:
type: string
storageClass:
type: string
labelSelector:
type: object
journal:
type: object
properties:
storage:
type: string
storageClass:
type: string
labelSelector:
type: object
logs:
type: object
properties:
storage:
type: string
storageClass:
type: string
labelSelector:
type: object
required:
- members
required:
- version
- applicationDatabase
helm_chart/crds/webhook-cluster-role.yaml deleted 100644 → 0
View file @ 64d8d739
---
kind: ClusterRole
apiVersion: rbac.authorization.k8s.io/v1
metadata:
name: mongodb-enterprise-operator-mongodb-webhook
rules:
- apiGroups:
- "admissionregistration.k8s.io"
resources:
- validatingwebhookconfigurations
verbs:
- get
- create
- update
- delete
helm_chart/templates/database-roles.yaml
View file @ 2d53ef1d
...@@ -8,10 +8,6 @@ metadata: ...@@ -8,10 +8,6 @@ metadata:
{{- else }} {{- else }}
namespace: {{ .Values.namespace }} namespace: {{ .Values.namespace }}
{{- end }} {{- end }}
{{- if .Values.registry.imagePullSecrets}}
imagePullSecrets:
- name: {{ .Values.registry.imagePullSecrets }}
{{- end }}
--- ---
apiVersion: v1 apiVersion: v1
...@@ -23,10 +19,6 @@ metadata: ...@@ -23,10 +19,6 @@ metadata:
{{- else }} {{- else }}
namespace: {{ .Values.namespace }} namespace: {{ .Values.namespace }}
{{- end }} {{- end }}
{{- if .Values.registry.imagePullSecrets}}
imagePullSecrets:
- name: {{ .Values.registry.imagePullSecrets }}
{{- end }}
--- ---
apiVersion: v1 apiVersion: v1
...@@ -38,10 +30,6 @@ metadata: ...@@ -38,10 +30,6 @@ metadata:
{{- else }} {{- else }}
namespace: {{ .Values.namespace }} namespace: {{ .Values.namespace }}
{{- end }} {{- end }}
{{- if .Values.registry.imagePullSecrets}}
imagePullSecrets:
- name: {{ .Values.registry.imagePullSecrets }}
{{- end }}
--- ---
kind: Role kind: Role
...@@ -57,7 +45,7 @@ rules: ...@@ -57,7 +45,7 @@ rules:
- apiGroups: - apiGroups:
- "" - ""
resources: resources:
- secrets - configmaps
verbs: verbs:
- get - get
......
helm_chart/templates/operator-roles.yaml
View file @ 2d53ef1d
...@@ -6,10 +6,6 @@ metadata: ...@@ -6,10 +6,6 @@ metadata:
{{- if .Values.namespace }} {{- if .Values.namespace }}
namespace: {{ .Values.namespace }} namespace: {{ .Values.namespace }}
{{- end }} {{- end }}
{{- if .Values.registry.imagePullSecrets}}
imagePullSecrets:
- name: {{ .Values.registry.imagePullSecrets }}
{{- end }}
--- ---
...@@ -47,15 +43,6 @@ rules: ...@@ -47,15 +43,6 @@ rules:
- watch - watch
- delete - delete
- update - update
{{- if eq (.Values.operator.watchNamespace | default "") "*" }}
- apiGroups:
- ""
resources:
- namespaces
verbs:
- list
- watch
{{- end}}
- apiGroups: - apiGroups:
- mongodb.com - mongodb.com
resources: resources:
......
helm_chart/templates/operator.yaml
View file @ 2d53ef1d
...@@ -10,15 +10,11 @@ spec: ...@@ -10,15 +10,11 @@ spec:
replicas: 1 replicas: 1
selector: selector:
matchLabels: matchLabels:
app.kubernetes.io/component: controller app: {{ .Values.operator.name }}
app.kubernetes.io/name: {{ .Values.operator.name }}
app.kubernetes.io/instance: {{ .Values.operator.name }}
template: template:
metadata: metadata:
labels: labels:
app.kubernetes.io/component: controller app: {{ .Values.operator.name }}
app.kubernetes.io/name: {{ .Values.operator.name }}
app.kubernetes.io/instance: {{ .Values.operator.name }}
spec: spec:
serviceAccountName: {{ .Values.operator.name }} serviceAccountName: {{ .Values.operator.name }}
{{- if not .Values.managedSecurityContext }} {{- if not .Values.managedSecurityContext }}
...@@ -61,33 +57,24 @@ spec: ...@@ -61,33 +57,24 @@ spec:
- name: MANAGED_SECURITY_CONTEXT - name: MANAGED_SECURITY_CONTEXT
value: 'true' value: 'true'
{{- end }} {{- end }}
- name: MONGODB_ENTERPRISE_DATABASE_IMAGE
value: {{ .Values.registry.operator }}/{{ .Values.database.name }}:{{ .Values.operator.version }}
- name: IMAGE_PULL_POLICY - name: IMAGE_PULL_POLICY
value: {{ .Values.registry.pullPolicy }} value: {{ .Values.registry.pullPolicy }}
# Database
- name: MONGODB_ENTERPRISE_DATABASE_IMAGE
value: {{ .Values.registry.database }}/{{ .Values.database.name }}
- name: INIT_DATABASE_IMAGE_REPOSITORY
value: {{ .Values.registry.initDatabase }}/{{ .Values.initDatabase.name }}
- name: INIT_DATABASE_VERSION
value: {{ .Values.initDatabase.version }}
- name: DATABASE_VERSION
value: {{ .Values.database.version }}
# Ops Manager
- name: OPS_MANAGER_IMAGE_REPOSITORY - name: OPS_MANAGER_IMAGE_REPOSITORY
value: {{ .Values.registry.opsManager }}/{{ .Values.opsManager.name }} value: {{ .Values.registry.opsManager }}/{{ .Values.opsManager.name }}
- name: INIT_OPS_MANAGER_IMAGE_REPOSITORY - name: INIT_OPS_MANAGER_IMAGE_REPOSITORY
value: {{ .Values.registry.initOpsManager }}/{{ .Values.initOpsManager.name }} value: {{ .Values.registry.initOpsManager }}/{{ .Values.initOpsManager.name }}
- name: INIT_OPS_MANAGER_VERSION - name: INIT_OPS_MANAGER_VERSION
value: {{ .Values.initOpsManager.version }} value: {{ .Values.initOpsManager.version }}
# AppDB
- name: APPDB_IMAGE_REPOSITORY
value: {{ .Values.registry.appDb }}/{{ .Values.appDb.name }}
- name: INIT_APPDB_IMAGE_REPOSITORY - name: INIT_APPDB_IMAGE_REPOSITORY
value: {{ .Values.registry.initAppDb }}/{{ .Values.initAppDb.name }} value: {{ .Values.registry.initAppDb }}/{{ .Values.initAppDb.name }}
- name: INIT_APPDB_VERSION - name: INIT_APPDB_VERSION
value: {{ .Values.initAppDb.version }} value: {{ .Values.initAppDb.version }}
- name: OPS_MANAGER_IMAGE_PULL_POLICY - name: OPS_MANAGER_IMAGE_PULL_POLICY
value: {{ .Values.registry.pullPolicy }} value: {{ .Values.registry.pullPolicy }}
- name: APPDB_IMAGE_REPOSITORY
value: {{ .Values.registry.appDb }}/{{ .Values.appDb.name }}
{{- if .Values.registry.imagePullSecrets }} {{- if .Values.registry.imagePullSecrets }}
- name: IMAGE_PULL_SECRETS - name: IMAGE_PULL_SECRETS
value: {{ .Values.registry.imagePullSecrets }} value: {{ .Values.registry.imagePullSecrets }}
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment

UNCLASSIFIED