Skip to main content

Installing Data

1. Create a new application​

From the ArgoCD Web UI, select Applications on the left side menu, and then click on the + NEW APP button

argocd-create-app

2. App Metadata​

Fill out the GENERAL form:

  • give a name to this Data deployment. It's suggested to use lowercase kebab-case such as data-dev or staging-customer-cloud
  • use the project default
  • leave the sync policy as Manual

argocd-app-general

3. App Source​

Fill out the SOURCE form:

  • select the only Repository URL from the dropdown menu
  • select the Chart data
  • choose the version of Data you want to deploy. It is highly recommended to deploy the latest release
warning

Pre-release versions such as 3.0.0-alpha.1 are experimental and should be avoided unless you know what you're doing.

argocd-app-source

4. App Destination​

Fill out the DESTINATION form:

  • select the only Cluster URL from the dropdown menu (https://kubernetes.default.svc)
  • type default as the chosen Namespace to deploy Data

argocd-app-destination

5. Data Configuration​

Data is configured from VALUES input panel inside the Helm section.

info

The below configurations are just an example for a Data deployment with Webup and Kokos.

To see advanced Data configurations, look at the configuration docs.

Copy the configurations below into your editor of choice and fill these two fields:

  • kokos.dsl.defaultApiKey - this API Key will be provided to you by Smeup
  • webup.webup.cfg.devModePassword - a strong password to access webup's admin console
# -- Kokos Configurations
kokos:
  enabled: true

  # -- Kokos DSL configurations
  dsl:
    # -- Default APIKey or PAT to authenticate to the DSL repositories
    # Note: this token is provided by Smeup
    defaultApiKey: ""

# -- Webup Configurations
webup:
  # -- Enable Webup subchart
  enabled: true
  # -- Webup configurations
  webup:
    cfg:
      # -- Password to enable Webup's Developer Mode
      devModePassword: ""

  # -- as400-proxy configs
  as400proxy:
    # -- Install as400-proxy
    enabled: false

# -- RestAPI Configurations
restapi:
  # -- Install RestAPI
  enabled: false

Finally, paste the YAML configs into the VALUES form inside the ArgoCD Web UI and click the CREATE button in the top side of the UI.

6. Sync (Deploy) Data​

After creating the Data application, it will have Missing app health and an OutOfSync status. To sync (deploy) Data, click on the SYNC button

argocd-sync-button

From the sync menu, make sure to check the PRUNE option and click SYNCHRONIZE

argocd-sync

ArgoCD will start deploying Data. The process may take a few minutes during the first installation, since all the container images need to be pulled from scratch.

You can check the status of the installation from the APP HEALTH indicator. It will change from Progressing to Healthy once the installation is done.

argocd-data-installed

Congratulations, you've successfully installed Data through AHD! 🎉