App Store Management¶

Administrator guide for managing the developer app store.

Overview¶

The app store provides a curated catalog of developer tools that are security vetted, version controlled, and highly configurable.

Catalog Structure¶

packages/organization/app-store/catalog.yml defines available applications:

apps:
  docker:
    name: Docker
    description: Container platform
    category: containers
    default_version: "24.0"
  kubectl:
    name: Kubernetes CLI
    description: Kubernetes command-line tool
    category: kubernetes
    default_version: "1.28"

Adding New Applications¶

1. Create Ansible Role¶

mkdir -p shared/ansible/roles/app-myapp/{tasks,defaults,templates}

2. Define Installation Logic¶

shared/ansible/roles/app-myapp/tasks/main.yml:

---

- name: Install MyApp
  ansible.builtin.package:
    name: myapp
    state: present
  when: apps.myapp.enabled | default(false)

3. Add to Catalog¶

Update catalog.yml:

myapp:
  name: MyApp
  description: Description here
  category: tools
  default_version: "1.0.0"

4. Add Configuration¶

Update packages/organization/ansible/group_vars/apps.yml:

myapp:
  enabled: false
  version: "1.0.0"
  config:
    option1: value1

5. Test¶

make test-org

Removing Applications¶

Mark as deprecated in catalog
Update documentation
Notify users
Remove after grace period

Updating Versions¶

Test new version thoroughly
Update default version in catalog
Document breaking changes
Communicate to users

Security Vetting¶

All apps must pass:

Security scan
License review
Vulnerability check
Configuration review