Artifactory Bootstrap

Bootstrap the Artifactory admin password and configuration with Helm Charts.

Bootstrap the Artifactory Admin Password

You can bootstrap the admin user password as described in Recreating the Default Admin User.

1. Create admin-creds-values.yaml and provide the IP (by default 127.0.0.1) and password.

   YAML

   artifactory:
     admin:
       ip: "<IP_RANGE>" # Example: "*" to allow access from anywhere
       username: "admin"
       password: "<PASSWD>"

2. Apply the admin-creds-values.yaml file.

   Artifactory

   Bash

   helm upgrade --install artifactory --namespace artifactory jfrog/artifactory -f admin-creds-values.yaml

   Artifactory HA

   Bash

   helm upgrade --install artifactory-ha --namespace artifactory-ha jfrog/artifactory-ha -f admin-creds-values.yaml

3. Restart the Artifactory pod (kubectl delete pod <pod_name>).

Bootstrap the Artifactory Configuration

Use Helm charts to bootstrap the Artifactory global and security configuration. An Artifactory subscription is required.

1. Create a bootstrap-config.yaml with an artifactory.config.import.xml and a security.import.xml as shown below.

   YAML

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: my-release-bootstrap-config
   data:
     artifactory.config.import.xml: |
       <config contents>
     security.import.xml: |
       <config contents>

2. Create a configMap in Kubernetes.

   Bash

   kubectl apply -f bootstrap-config.yaml

3. Pass the configMap to Helm using one of the following options.

   Artifactory

   Bash

   helm upgrade --install artifactory --set artifactory.license.secret=artifactory-license,artifactory.license.dataKey=art.lic,artifactory.configMapName=my-release-bootstrap-config --namespace artifactory jfrog/artifactory

   Artifactory HA

   Bash

   helm upgrade --install artifactory-ha --set artifactory.license.secret=artifactory-license,artifactory.license.dataKey=art.lic,artifactory.configMapName=my-release-bootstrap-config --namespace artifactory-ha jfrog/artifactory-ha

   or

   Artifactory

   Bash

   helm upgrade --install artifactory --set artifactory.license.licenseKey=<LICENSE_KEY>,artifactory.configMapName=my-release-bootstrap-config --namespace artifactory jfrog/artifactory

   Artifactory HA

   Bash

   helm upgrade --install artifactory-ha --set artifactory.license.licenseKey=<LICENSE_KEY>,artifactory.configMapName=my-release-bootstrap-config --namespace artifactory-ha jfrog/artifactory-ha

   For more information, see Bootstrapping the Artifactory Global Configuration and Bootstrapping the Artifactory Security Configuration.

Copy Configuration Files for Every Startup

The chart copies files from /artifactory-extra-conf to ARTIFACTORY_HOME/etc only on first startup. To copy configuration files to ARTIFACTORY_HOME/etc on every startup, use the copyOnEveryStartup setting.

For example, with the default behavior, binarystore.xml is only copied on the first startup, so later changes to the binarystore.xml configuration are not applied.

1. To apply changes on every startup, create a YAML block with the following values:

   YAML

   artifactory: 
     copyOnEveryStartup: 
       - source: /artifactory_bootstrap/binarystore.xml 
         target: etc/artifactory

2. Install the Helm chart with the values file you created:

   Artifactory

   Bash

   helm upgrade --install artifactory --namespace artifactory jfrog/artifactory -f values.yaml

   Artifactory HA

   Bash

   helm upgrade --install artifactory-ha --namespace artifactory-ha jfrog/artifactory-ha -f values.yaml

For any custom configuration file, such as logback.xml:

1. Create a configMap with your logback.xml configuration.

2. Next, create a values.yaml file with the following values:

   YAML

   artifactory:
     ## Create a volume pointing to the config map with your configuration file
     customVolumes: |
       - name: logback-xml-configmap
         configMap:
           name: logback-xml-configmap
     customVolumeMounts: |
       - name: logback-xml-configmap
         mountPath: /tmp/artifactory-logback/
     copyOnEveryStartup:
       - source: /tmp/artifactory-logback/*
         target: etc/artifactory

3. Install the Helm chart with the values file you created:

   Artifactory

   Bash

   helm upgrade --install artifactory --namespace artifactory jfrog/artifactory -f values.yaml

   Artifactory HA

   Bash

   helm upgrade --install artifactory-ha --namespace artifactory-ha jfrog/artifactory-ha -f values.yaml