https://github.com/akamai-compute-marketplace/marketplace-apps
The Official Akamai Compute (formally Linode) Marketplace
https://github.com/akamai-compute-marketplace/marketplace-apps
Last synced: 4 months ago
JSON representation
The Official Akamai Compute (formally Linode) Marketplace
- Host: GitHub
- URL: https://github.com/akamai-compute-marketplace/marketplace-apps
- Owner: akamai-compute-marketplace
- License: gpl-3.0
- Created: 2023-05-19T18:44:27.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-08T16:09:07.000Z (5 months ago)
- Last Synced: 2024-11-15T22:22:56.589Z (5 months ago)
- Language: Shell
- Size: 8.59 MB
- Stars: 17
- Watchers: 1
- Forks: 22
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - akamai-compute-marketplace/marketplace-apps - The Official Akamai Compute (formally Linode) Marketplace (Shell)
README
# Linode Marketplace Apps
The Linode Marketplace is designed to make it easier for developers and companies to share [One-Click Apps](https://www.linode.com/marketplace/) with the Linode community. One-Click Apps are portable and modular solutioning tools written as Ansible playbooks. The Linode Marketplace allows users to quickly deploy services and perform essential configurations on a Linode compute instance's first boot.
A Marketplace deployment refers to an application (single service on a single node) or a cluster (multi-node clustered service such as Galera). A combination of StackScripts and Ansible playbooks give the Marketplace a one-click installation and delivery mechanism for deployments. The end user is billed just for the underlying cloud resources (compute instances, storage volumes, etc) in addition to any applicable BYOLs.
## Marketplace App Development Guidelines.
A Marketplace application consists of three major components: a Stackscript, Ansible playbooks, and Git repository to clone from.
### Stackscript
A [Stackscript](https://www.linode.com/docs/products/tools/stackscripts/guides/write-a-custom-script) is a Bash script adhering to industry best practices that is stored on Linode hosts and is accessible to all customers.
### Ansible Playbook
All Ansible playbooks should generally adhere to the [sample directory layout](https://docs.ansible.com/ansible/latest/user_guide/sample_setup.html#sample-ansible-setup) and best practices/recommendations from the latest Ansible [User Guide](https://docs.ansible.com/ansible/latest/user_guide/index.html).
### Helper Functions
Linode Helpers are static roles that can be called at will when we are trying to accomplish a repeatable system task. Instead of rewriting the same function for multiple One-Click Apps, we can simply import the Helper role to accomplish the same effect. This results in basic system configurations being performed predictably and reliably, without the variance of individual authors.
More detailed information on Linode Helper functions and variables can be found in the [Linode Helper Readme](apps/linode_helpers/README.md).
For more information on roles please refer to the [Ansible documentation](https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html#using-roles-at-the-play-level).
## Creating Your Own
For more information on creating and submitting a Partner App for the Linode Marketplace please see [Contributing](docs/CONTRIBUTING.md) and [Development](docs/DEVELOPMENT.md).