From a0a3094f1add2402ca313e2b6df71fa93e1f6939 Mon Sep 17 00:00:00 2001 From: Bill Maxwell Date: Fri, 15 Dec 2023 15:42:03 -0700 Subject: [PATCH] Add a readme Signed-off-by: Bill Maxwell --- Acornfile | 34 +++++++++++++++++----------------- README.md | 36 ++++++++++++++++++++++++++++++++++++ 2 files changed, 53 insertions(+), 17 deletions(-) create mode 100644 README.md diff --git a/Acornfile b/Acornfile index 3c2be62..26544e6 100644 --- a/Acornfile +++ b/Acornfile @@ -43,20 +43,20 @@ secrets: config: { } localData: instructions: """ - ## Overview - - This will create the service from an existing MongoDB so that it can be swapped with the MongoDB container service. - - ## Instructions - - fill in: - - - address: the address of the MongoDB server (mongo.example.com) - - port: the port of the MongoDB server (27017) - - username: the username to use to connect to the MongoDB server - - password: the password to use to connect to the MongoDB server - - adminUsername: the username to use to connect to the MongoDB server as an admin - - adminPassword: the password to use to connect to the MongoDB server as an admin - - proto: the protocol to use to connect to the MongoDB server (mongodb or mongodb+srv) - - dbName: the name of the database to use - """ + ## Overview + + This will create the service from an existing MongoDB so that it can be swapped with the MongoDB container service. + + ## Instructions + + fill in: + + - address: the address of the MongoDB server (mongo.example.com) + - port: the port of the MongoDB server (27017) + - username: the username to use to connect to the MongoDB server + - password: the password to use to connect to the MongoDB server + - adminUsername: the username to use to connect to the MongoDB server as an admin + - adminPassword: the password to use to connect to the MongoDB server as an admin + - proto: the protocol to use to connect to the MongoDB server (mongodb or mongodb+srv) + - dbName: the name of the database to use + """ diff --git a/README.md b/README.md new file mode 100644 index 0000000..6b53cd6 --- /dev/null +++ b/README.md @@ -0,0 +1,36 @@ +# MongoDB External + +This repo is an Acorn for connecting external MongoDB instances to your application through the standardized MongoDB service interface. This allows you to swap out the containerized MongoDB instance for one that is hosted externally. + +## Usage + +This Acorn will prompt the user for the following information: + +- address: the address of the MongoDB server (mongo.example.com) +- port: the port of the MongoDB server (27017) +- username: the username to use to connect to the MongoDB server +- password: the password to use to connect to the MongoDB server +- adminUsername: the username to use to connect to the MongoDB server as an admin +- adminPassword: the password to use to connect to the MongoDB server as an admin +- proto: the protocol to use to connect to the MongoDB server (mongodb or mongodb+srv) +- dbName: the name of the database to use + +This information will be rendered into the Acorn service object. + +If you run + +```bash +acorn run -n mongodb-external ghcr.io/acorn-io/mongodb-external +``` + +It will require you to run: + +```bash +acorn login mongodb-external +``` + +Which is the app name. This will trigger Acorn to prompt you. + +## Examples + +To see how to setup an application to use this Acorn, see the [examples](examples) directory.