Score provides a developer-centric and platform-agnostic workload specification to improve developer productivity and experience. Score eliminates configuration inconsistencies between local and remote environments.
The Platform CLI is a conversion tool for application developers to generate an environment specific configuration. In combination with environment specific parameters, The Platform CLI tool can run your Workload in the target environment by generating the target platform's configuration file.
-
Open https://github.com/score-spec/score-humanitec/releases in your browser.
-
Find the current release by scrolling down and looking for the green tag that reads Latest.
-
Download the latest compressed Tar file for your operating system.
- The name will be something like
score-humanitec_x.y_osx-amd64.tar.gz
, wherex.y
is the release number,osx
is the operating system. - By default, the tarball will be saved to your
~/Downloads
directory. If you choose to use a different location, you'll need to change that in the following steps.
- The name will be something like
Results You should see something similar to the following output.
Saving to: `score-humanitec_x.y_osx-amd64.tar.gz`
score-humanitec_x.y.0 100%[===================>] 2.85M 5.28MB/s in 0.5s
In your terminal, enter the following to create the score-spec
directory.
cd /usr/local/
# create the directory if needed
sudo mkdir -pv score-spec
Extract the compressed Tar file.
sudo tar -xvzf ~/Downloads/score-humanitec_0.1.0_darwin_arm64.tar.gz
Results You should see the following output.
x LICENSE
x README.md
x score-humanitec
To export PATH
, run the following command.
export PATH=$PATH:/usr/local/score-spec
To verify installation, run the following command.
score-humanitec --version
The previous command returns the following output.
score-humanitec x.y.z
Results You've successfully installed the Platform CLI.
The Score specification file resolves configuration inconsistencies between environments. Compose a score.yaml
file that describes how to run your Workload. As a platform-agnostic declaration file, score.yaml
creates a single source of truth on Workload profiles and works to integrate with any platform or tooling.
# Prepare a new Humanitec deployment delta
score-humanitec run -f ./score.yaml --env test-env
- Enable local development without risk of configuration inconsistencies in remote environments.
- Offer default configuration while allowing for a large degree of customization.
- Establish a single source of truth for application configuration.
- Separate environment specific from environment agnostic configuration.
- Enable environment agnostic declaration of infrastructure dependencies.
- Enable application centric rather than infrastructure centric development.
- Abstract away infrastructural complexity without sacrificing transparency.
For more information, see the Score manifesto.
- Give the project a star!
- Contact us via Email:
- See our documentation.
- Provide feedback on our road map and releases board.
- Contribute.
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also open an issue with the tag enhancement
.
- Fork the Project.
- Create your Feature Branch.
git checkout -b feature/feature-name
- Commit your Changes.
git commit -s -m "Add some AmazingFeature"
- Push to the Branch.
git push origin feature/feature-name
- Open a Pull Request.
Read CONTRIBUTING for more information.