Saas 5935 - CHANGELOG (#94)

Author: Oleg Sucharevich

CHANGELOG/CHANGELOG-1.0.MD

@@ -0,0 +1,13 @@
+Version 1.0 brings a lot of changes, both in the way Codefresh addressing the underline resource and they way we expose the management of it.
+* We highly suggest to no use `venona` binary directly from now on, use [Codefresh official CLI](https://cli.codefresh.io/).
+* Introduction of agent entity in Codefresh, from now on, all the new runtime-environments will be managed by an agent, see `codefresh get agent --help`.
+    * Account can have multiple agents.
+    * Agent can manage multiple runtime environments.
+    * Runtime environment can be managed by one agent.
+    * `codefresh create agent` will print you a token (this is a limited scoped token), that will be used by the Venona pod to talk to Codefresh API.
+    * Venona pod (or the process) must have a network connection the the runtime environmens that he is manages
+* Seperation of commands
+    * `venona install` is now deprecated, instead we have `codefresh install agent` and `codefresh install runtime` which will use Venona binary.
+* `codefresh install agent` will not create a service-account,role and rolebinding, means the the Venona pod will start with the default service account of the namespace.
+* `codefresh install runtime` will create additional service-account,role and rolebinding, this service-account data will be injected to Venona pod during `codefresh attach runtime` flow.
+* `codefresh/venona:latest` image is now the latest of the 0.x.x versions

README.md

@@ -3,7 +3,12 @@
 [![Codefresh build status]( https://g.codefresh.io/api/badges/pipeline/codefresh-inc/codefresh-io%2Fvenona%2Fvenona?type=cf-1)]( https://g.codefresh.io/public/accounts/codefresh-inc/pipelines/codefresh-io/venona/venona)
 
 ## Version 1.x.x
-Version 1.0.0 is released now, read more about migration from older version [here](#Migration)  
+Version 1.x.x is is about to be released soon, read more about migration from older version [here](#Migration)  
+Meanwhile 1.x.x is to release and makred as pre-release we will maintain 2 branches:
+* `master` - the previous version ( `version < 1.0.0` )
+  * we will keep maintaing if (bugs, security issues) - this version will be intalled when installing `venona` on MacOS using brew
+  * `codefresh/venona:latest` will refer to this branch
+* `release-1.0` it the new release, which will be used when running Codefresh CLI to install the agent
 We highly suggest to use [Codefresh official CLI](https://codefresh-io.github.io/cli/) to install the agent:
 ```bash
 kubectl create namespace codefresh

Troubleshooting.md

@@ -0,0 +1,5 @@
+* With the release of version 1.x.x we are releasing a lot of new features, please checkout the [changelog](https://github.com/codefresh-io/venona/blob/release-1.0/CHANGELOG/CHANGELOG-1.0.MD)
+
+* To migrate to the new version, please use the [migration script](https://github.com/codefresh-io/venona/blob/release-1.0/scripts/migration.sh)
+
+* We do not expect any unexpected behaviour for users that are already running previous versions ( `version < 1.0.0` )