@@ -28,7 +28,7 @@ with the codestream-server sandbox in a playground. AWS SQS requires an AWS IAM
2828access key or the codestream-server sandbox to run on a managed EC2 development
2929instance.
3030
31- ## Installation on a Managed VM
31+ ## Installation
3232
3333Probably the fastest way to get started would be by launching your own private
3434development VM and running a setup script that will prepare your entire
@@ -58,7 +58,24 @@ framework.
5858 If you have any custom alterations to the standard configuration, you will
5959 need to be familiar with the procedures in this document.
6060
61- ### Installation
61+ ### Quick and Dirty
62+
63+ The framework includes an installation script that does all the work. If you
64+ don't have the framework installed on your notebook, you could spin up a
65+ development instance for yourself. [ This is documented
66+ here] ( https://dtops-docs.codestream.us/netuser/resources/dev-vms/ ) .
67+
68+ This will install all the codestream sandboxes including the front-end client
69+ repo, onprem-install and backend repos.
70+ ```
71+ dt-dev-setup --codestream
72+ ```
73+
74+ ### Installation & Setup Using dev_tools Framework commands
75+
76+ This is _ mostly_ what the ** dt-dev-setup** script will do, but reduced to the
77+ sandboxes applicable solely to the CodeStream Back-End services.
78+
62791 . Update your secrets (` dt-update-secrets -y ` ).
63801 . Select a codestream configuration to use (details documented
6481 [ here] ( ../api_server/docs/unified-cfg-file.md ) ). To get up and running quickly, this
@@ -67,8 +84,7 @@ framework.
6784 echo codestream-cloud > ~/.codestream/config/codestream-cfg-default.local
6885 ```
69861 . Open a new terminal window, without any sandboxes loaded.
70- 1 . If you're using a mongo sandbox, load it into your shell and start the mongo
71- service.
87+ 1 . If you're using a mongo sandbox, load it into your shell.
7288 ```
7389 dt-load mongo
7490 mdb-service start
@@ -98,3 +114,23 @@ new shells for codestream backend development:
98114```
99115dt-load-playground csbe
100116```
117+ You are good to go.
118+
119+ ## Loading the Playground
120+
121+ 1 . In a new shell, load the backend playground with the command
122+ ` dt-load-playground csbe ` or ` dlp csbe ` . This sets your shell up with the
123+ mongo and backend server mono-repo sandboxes. Run ` dt-env ` to see them.
124+
125+ 1 . Control mongo with the ` mdb-service ` command
126+ ```
127+ mdb-service { start | stop | status }
128+ ```
129+
130+ 1 . See the backend mono-repo commands with ` csbe-help ` . Since the mono-repo
131+ effectively loads all the component sandboxes (api, mailout, mailin,
132+ broadcaster, onprem-admin), all of those commands are available as well. Use
133+ ` cs_api-help ` , ` cs_outbound_email-help ` , ` cs_mailin-help ` ,
134+ ` cs_broadcaster-help ` and ` opadm-help ` .
135+
136+ Happy coding!.
0 commit comments