diff --git a/Dockerfile b/Dockerfile
index a885466..28c9350 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -3,7 +3,7 @@ FROM alpine:3.19.1
ARG USER=ext-installer
ENV HOME /home/$USER
-RUN apk update && apk add file curl
+RUN apk update && apk add file curl jq
RUN adduser -D $USER
USER $USER
diff --git a/README.md b/README.md
index 8ed58be..01b05f4 100644
--- a/README.md
+++ b/README.md
@@ -11,9 +11,133 @@ and install the configured UI extension. All configuration is provided
as environment variables as part of the init container. Find below the
list of all environment variables that can be configured:
-| Env Var | Required? | Default | Description |
-|------------------------|-----------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| EXTENSION_ENABLED | No | true | If set to false will skip the installation. Noop |
-| EXTENSION_URL | Yes | "" | Must be set to a valid URL where the UI extension can be downloaded from.
Argo CD API server needs to have network access to this URL. |
-| EXTENSION_CHECKSUM_URL | No | "" | Can be set to the file containing the checksum to validate the downloaded
extension. Will skip the checksum validation if not provided.
Argo CD API server needs to have network access to this URL. |
-| MAX_DOWNLOAD_SEC | No | 30 | Total time in seconds allowed to download the extension. |
+| Env Var | Required? | Default | Description |
+|---------------------------|----------|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| EXTENSION_NAME | Yes | "" | Extension Name |
+| EXTENSION_ENABLED | No | true | If set to false will skip the installation. Noop |
+| EXTENSION_URL | Yes | "" | Must be set to a valid URL where the UI extension can be downloaded from.
Argo CD API server needs to have network access to this URL. |
+| EXTENSION_VERSION | Yes | "" | The version of the extension to be installed. |
+| EXTENSION_CHECKSUM_URL | No | "" | Can be set to the file containing the checksum to validate the downloaded
extension. Will skip the checksum validation if not provided.
Argo CD API server needs to have network access to this URL. |
+| MAX_DOWNLOAD_SEC | No | 30 | Total time in seconds allowed to download the extension. |
+| EXTENSION_JS_VARS | No | "" | Export the variables to `extension-$EXTENSION_JS_VARS` in js file within the extension folder. These variables will be exported as env variables with key `${EXTENSION_NAME}_VARS`.
The format should be `{key1=value1, key2=value2}`. |
+
+
+
+```yaml
+apiVersion: v1
+kind: ConfigMap
+metadata:
+ name: extension-cm
+data:
+ extension.url: 'http://example.com/extension.tar.gz'
+ extension.version: 'v0.3.1'
+ # optional fields
+ extension.name: 'example'
+ extension.enabled: 'true'
+ extension.checksum_url: 'http://example.com/extension_checksums.txt'
+ extension.max_download_sec: '30'
+ extension.js_vars : |
+ {
+ "key1": "value1",
+ "key2": "value2"
+ }
+
+```
+
+```yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+ name: argocd-server
+spec:
+ template:
+ spec:
+ initContainers:
+ - name: extension
+ # The image digest must be appended after the tag.
+ # New tag digest can be obtained in quay by clicking in the
+ # "fetch tag" icon and select "Docker Pull (by digest)":
+ # https://quay.io/repository/argoprojlabs/argocd-extension-installer?tab=tags
+ image: docker.intuit.com/quay-rmt/argoprojlabs/argocd-extension-installer:v0.0.1@sha256:f50fa11a4592f3fcdd5a137dab8ed32067bb779a77a393f179e8a5d96abe1a80
+ env:
+ - name: EXTENSION_NAME
+ valueFrom:
+ configMapKeyRef:
+ key: extension.name
+ name: extension-cm
+ - name: EXTENSION_URL
+ valueFrom:
+ configMapKeyRef:
+ key: extension.url
+ name: extension-cm
+ - name: EXTENSION_VERSION
+ valueFrom:
+ configMapKeyRef:
+ key: extension.version
+ name: extension-cm
+ - name: EXTENSION_CHECKSUM_URL
+ valueFrom:
+ configMapKeyRef:
+ key: extension.checksum_url
+ name: extension-cm
+ ## Optional fields
+ - name: $EXTENSION_JS_VARS
+ valueFrom:
+ configMapKeyRef:
+ key: extension.js_vars
+ name: extension-cm
+ volumeMounts:
+ - name: extensions
+ mountPath: /tmp/extensions/
+ securityContext:
+ runAsUser: 1000
+ allowPrivilegeEscalation: false
+ containers:
+ - name: argocd-server
+ volumeMounts:
+ - name: extensions
+ mountPath: /tmp/extensions/
+```
+
+### Exporting env as js extensions
+
+Add the below config in the `extension-cm`:
+```yaml
+#name should match with the extension name e.g 'Metrics', 'Rollout', 'Ephemeral-Access'
+extension.name: 'example'
+extension.js_vars : |
+ {
+ "key1": "value1",
+ "key2": "value2"
+ }
+```
+Provide the config in argocd-server deployment as below:
+```yaml
+ ## Optional fields
+ - name: $EXTENSION_JS_VARS
+ valueFrom:
+ configMapKeyRef:
+ key: extension.js_vars
+ name: extension-cm
+```
+output:
+```js
+((window) => {
+ const vars = {
+ "key1": "value1", "key2": "value2"
+ };
+ window.EXAMPLE_VARS = vars;
+})(window);
+```
+
+Use the exported variables in the extension js file as below:
+```js
+console.log(window.EXAMPLE_VARS.key1);
+console.log(window.EXAMPLE_VARS.key2);
+```
+
+Debug:
+```text
+To test the exported env variables, open the developer console in the browser and type `window` to see the exported variables. The output should be similar to the below:
+```
+
diff --git a/image/exported_envirnoment_variables.png b/image/exported_envirnoment_variables.png
new file mode 100644
index 0000000..d97347e
Binary files /dev/null and b/image/exported_envirnoment_variables.png differ
diff --git a/install.sh b/install.sh
index 6731b8f..7596035 100755
--- a/install.sh
+++ b/install.sh
@@ -63,9 +63,30 @@ install_extension() {
mkdir -p /tmp/extensions/resources
fi
cp -Rf resources/* /tmp/extensions/resources/
+
+ if [ -n "$ext_vars" ] && [ -n "$ext_name" ]; then
+ create_extension_js_file_with_vars
+ fi
+
echo "UI extension installed successfully"
+
}
+create_extension_js_file_with_vars() {
+ echo "Generating extension vars js file..."
+ ext_installed_path=$(find /tmp/extensions/resources -type d -name "extension*-$ext_name*.js" | head -n 1)
+ sanitized_extension_name=$(echo "${ext_name//-/_}" | tr '[:lower:]' '[:upper:]')
+ ext_js_file_name="${sanitized_extension_name}_vars"
+ js_file_path="${ext_installed_path}/extension-0-${ext_js_file_name}.js"
+ js_variable=$(echo "$ext_vars" | jq -r 'to_entries | map("\"" + (.key | ascii_upcase) + "\": \"" + .value + "\"") | join(", ")')
+ js_vars_wrap="((window) => { const vars = { $js_variable }; window.${sanitized_extension_name}_VARS = vars; })(window);"
+ if [ -d "$ext_installed_path" ]; then
+ echo "Exporting extension vars file at $js_file_path"
+ echo "$js_vars_wrap" > "$js_file_path"
+ else
+ echo "$ext_installed_path path doesn't exist, extension vars failed to be exported "
+ fi
+}
## Script
ext_enabled="${EXTENSION_ENABLED:-true}"
@@ -84,11 +105,16 @@ if [ "$ext_url" = "" ]; then
fi
checksum_url="${EXTENSION_CHECKSUM_URL:-}"
download_max_sec="${MAX_DOWNLOAD_SEC:-30}"
+
ext_filename=$(basename -- "$ext_url")
download_dir=`mktemp -d -t extension-XXXXXX`
ext_file="$download_dir/$ext_filename"
if [ -f $ext_file ]; then
rm $ext_file
fi
+
+ext_vars=$(echo "$EXTENSION_JS_VARS" | jq -c '.')
+
download_extension
install_extension
+