Skip to content

Commit 787c9d2

Browse files
committed
README Cleanup
1 parent 911cb4d commit 787c9d2

File tree

1 file changed

+10
-8
lines changed

1 file changed

+10
-8
lines changed

README.md

+10-8
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ The implementation is actually quite simple. It just follows the steps below:
4747
- Provides a clear and concise view of the changes
4848
- Render resources from external sources (e.g., Helm charts). For example, when you update the chart version of Nginx, you can get a render of the new output. For example, this is useful to spot changes in default values. [PR example](https://github.com/dag-andersen/argocd-diff-preview/pull/15).
4949

50-
### Not supported
50+
#### Not supported
5151
- Does not support ArgoCD CMP plugins
5252
- Does not work [Cluster Generators](https://argocd-applicationset.readthedocs.io/en/stable/Generators-Cluster/) in your ApplicationSets
5353

@@ -73,7 +73,7 @@ docker run \
7373

7474
and the output would be something like this:
7575

76-
```bash
76+
```
7777
...
7878
🚀 Creating cluster...
7979
🚀 Cluster created successfully
@@ -100,12 +100,13 @@ Pre-requisites:
100100
docker run \
101101
--network host \ # This is required so the container can access the local cluster on the host's docker daemon.
102102
-v /var/run/docker.sock:/var/run/docker.sock \ # This is required to access the host's docker daemon.
103-
-v <path-to-main-branch>:/base-branch \ # This is the main branch's ArgoCD applications.
103+
-v <path-to-main-branch>:/base-branch \
104104
-v <path-to-pr-branch>:/target-branch \
105105
-v $(pwd)/output:/output \
106-
-e base_branch=main \
107-
-e target_branch=<name-of-the-target-branch> \
108-
dag-andersen/argocd-diff
106+
-e BASE_BRANCH=main \
107+
-e TARGET_BRANCH=<name-of-the-target-branch> \
108+
-e GIT_REPO="https://github.com/dag-andersen/argocd-diff-preview.git" \
109+
dagandersen/argocd-diff-preview:latest
109110
```
110111

111112
<details>
@@ -170,7 +171,7 @@ cargo run -- --help
170171

171172
### Handling credentials
172173

173-
In the simple code example above, I do not provide the cluster with any credentials, which only works if the image registry and the git repository are public. Since your Git repository might not be public you need to provide the tool with the necessary read-access credentials for the repository. This can be done by placing the Argo CD repo secrets in folder mounted at `/secrets`. When the tool starts, it will simply run `kubectl apply -f /secrets` to apply every resource to the cluster, before starting the rendering process.
174+
In the simple code examples above, we do not provide the cluster with any credentials, which only works if the image registry and the git repository are public. Since your Git repository might not be public you need to provide the tool with the necessary read-access credentials for the repository. This can be done by placing the Argo CD repo secrets in folder mounted at `/secrets`. When the tool starts, it will simply run `kubectl apply -f /secrets` to apply every resource to the cluster, before starting the rendering process.
174175

175176
<details>
176177
<summary>Credentials example - Username + Password </summary>
@@ -218,7 +219,7 @@ For more info, see the [Argo CD docs](https://argo-cd.readthedocs.io/en/stable/o
218219
219220
### Scalability and performance
220221
221-
Rendering the manifests generated by all applications in the repository on each pull request is slow. This can be annoying, especially if only a few applications have changed. The tool supports grepping applications with regex. Setting the environment variable `FILE_REGEX` only allows the tool to run on manifests that match a particular regex.
222+
Rendering the manifests generated by all applications in the repository on each pull request is slow. The tool supports grepping applications with regex. Setting the environment variable `FILE_REGEX` only allows the tool to run on manifests that match a particular regex.
222223

223224
For example, If someone in your organization from Team A changes to one of their applications, the tool can be run with `FILE_REGEX=/Team-A/` so it only renders changes in folders matching `*/Team-A/*`. This speeds up the process significantly.
224225

@@ -249,6 +250,7 @@ OPTIONS:
249250
## Roadmap
250251
- Make a dedicated GitHub Action that wraps the Docker container, so the tool becomes more user-friendly.
251252
- Let the user specify Argo CD version. Currently it always uses the newest version available.
253+
- Let the user specify how many lines above and below the diff they want to see. This is useful when the diff is too big to be displayed in a PR comment.
252254
- Delete Argo CD Applications, when they have been parsed by the tool, so Argo CD can focus on the remaining applications, which hopefully speeds up the process.
253255
254256
## Do you experience any issues?

0 commit comments

Comments
 (0)