Skip to main content
Version: Next

For Linux

Table of Contents​

  1. Linux Provisioning
  2. Download and Configuration of Edge App Helm Chart
  3. Installation/Update/Deletion of Edge App
  4. Verification and Usage on Edge Conductor  

1. Linux Provisioning​

  • To use the resources of the Edge App infra, securing a key account is essential (Please inquire about the Key from the cloud administrator)

  • Install Edge App Helm chart

    git clone https://github.com/mellerikat/Edge-App.git

  • Execute linux provisioning shell

    ./linux_provisioning.sh

  • AWS ECR Login

    aws configure set aws_access_key_id {"AWS Access Key"}
    aws configure set aws_secret_access_key  {"AWS Secret Access Key"} 
    aws configure set default.region  {"region"}
    aws ecr get-login-password --region {region} | sudo docker login --username AWS --password-stdin {AWS Account ID}.dkr.ecr.{region}.amazonaws.com

2. Download and Configuration of Edge App Helm Chart​

  • First-time configuration of Edge App environment

    helm install init ./setup-package/edgeapp-setup-[--version].tgz -f [namespace_setting_file] -n {namespace}

    (example)

    helm install init ./setup-package/edgeapp-setup-1.0.0.tgz -f example/linux-setup-for-each-namespace.yaml -n edge-app

  • Select and modify one example file suitable for the environment and add it after the -f option

    • example/linux-setup-for-each-namespace.yaml

  • Configuration file for setting the environment in which Edge App operates (linux example)

    global:
        is_linux: True

    env:
        namespace: default
        serviceaccount: edge-app

    pv:
        pv_enable: True

3. Installation/Update/Deletion of Edge App​

  • 1. Installation and Update of Edge App​

    source ./linux-install.sh [edgeapp name] ./edgeapp-package/edgeapp-manifest-[--version].tgz example/linux-edgeapp.yaml -n {namespace}

    (example)

    helm install edgeapp-1 ./edgeapp-package/edgeapp-manifest-3.7.0.tgz -f example/linux-edgeapp-1.yaml -n default

    • Select and modify one example file suitable for the environment and add it after the -f option

      • example/linux-edgeapp.yaml

    • Configuration file storing user/infrastructure information of Edge App

    # linux-edgeapp.yaml -> linux edgeapp + cloud edgeconductor
    env:
        type: linux
        cluster: k3s
        controller_image_address: 339713051385.dkr.ecr.ap-northeast-2.amazonaws.com/mellerikat/release/edge-app/amd/controller:3.7.0-rc.1
        iomanager_image_address: 339713051385.dkr.ecr.ap-northeast-2.amazonaws.com/mellerikat/release/edge-app/amd/iomanager:3.7.0-rc.1
        redis_image_address: 339713051385.dkr.ecr.ap-northeast-2.amazonaws.com/mellerikat/release/edge-app/amd/redis:v7.2.3
        namespace: default
        serviceaccount: edge-app

    ecr:
        token_renewable: true
        image_host: https://339713051385.dkr.ecr.ap-northeast-2.amazonaws.com

    pv:
        pv_enable: True

    conductor:
        host: edgecond.mellerikat-dev.com
        http_protocol: https
        port: 443
        wsprotocol: wss

    appinfo:
        data_input_path: linux_test/input
        data_output_path: linux_test/output
        data_input_policy: copy #'move','copy'
        data_save_policy: add_utc #'overwrite','add_utc','add_date'
        enable_result_to_edgecond: True
        Note: linux-edgeapp-test
        host_path: /home

    cronjob:
        suspend: true
        base_image: 339713051385.dkr.ecr.ap-northeast-2.amazonaws.com/mellerikat/release/edge-app/amd/alpine/k8s:1.30.12
        edgeapp_cronjob_ecr_secret: edgeapp-cronjob-ecr-secret-helm
        ecr_token_command: |
            aws ecr get-login-password --region ap-northeast-2 && \
            kubectl delete secret --ignore-not-found {edgeapp_cronjob_ecr_secret} -n {namespace} && \
            kubectl create secret docker-registry {edgeapp_cronjob_ecr_secret} --docker-server={image_host} --docker-username=AWS --docker-password=$(aws ecr get-login-password --region ap-northeast-2) --namespace={namespace}

  • 2. Deletion of Edge App​

    helm uninstall [edgeapp name]

    (example)

    helm uninstall example1
    helm uninstall example2

  • 3. Deletion of Alo​

    kubectl delete pod [alo pod name] -n {namespace}

4. Verification and Usage on Cloud Edge Conductor​

  • Verify if the edge installed by the user is visible on the Edge Conductor
    • ex) {edgetest} -> {serial-number}{edgetest}