Compare commits
No commits in common. "0242c993883d4abaabfd9e430ea418d4bb9641d8" and "36102f22b4ce36cc6ec7a455754549e5c12f431c" have entirely different histories.
0242c99388
...
36102f22b4
|
@ -1,18 +0,0 @@
|
|||
== File System Layout == [ Piston ]
|
||||
|
||||
All of pistons files are installed in the `/piston` directory. This directory
|
||||
contains all runtimes, config, packages and cache that piston uses.
|
||||
|
||||
Each package gets its own directory, where it its prebuilt binaries are
|
||||
unpacked into. This is contained within `/piston/packages`
|
||||
|
||||
The binaries folder contained within this is then symlinked into the runtimes
|
||||
directory. This is where all the different runtimes available are placed. This
|
||||
is contained within the `/piston/runtimes` directory.
|
||||
|
||||
The cache directory a directory containing all the different cache files. It is
|
||||
recommended to either sym-link this into a folder withing /tmp/ or directly
|
||||
mount it as a tmpfs filesystem.
|
||||
|
||||
Configuration is stored in a single file - piston.yaml and contains all
|
||||
documentation required for configuring the piston API
|
|
@ -19,8 +19,8 @@ containing the right content - as long as its accessable by a URL, its
|
|||
considered a valid repository by piston. A repository URL is simply a URL
|
||||
pointing to a repository index file, as set out by the following information.
|
||||
|
||||
A repository index file is a YAML file containing the keys: `schema`,
|
||||
`baseurl`, `keys` and `packages`.
|
||||
A repository index file is a YAML file containing the keys: `schema`, `baseurl`
|
||||
and `packages`.
|
||||
|
||||
The schema key simply should have a value of `ppman-repo-1`. This indicates the
|
||||
version and file format for the client to recieve.
|
||||
|
@ -30,12 +30,9 @@ this doesn't need to be related to the url that the repository index is hosted
|
|||
at, only the downloadable files, which are possible to split over many domains
|
||||
by using absolute paths.
|
||||
|
||||
The keys key contains a list of GPG key ids which should be used when
|
||||
verifying.
|
||||
|
||||
The packages key contains a list of packages, which contain the keys: `author`,
|
||||
`language`, `version`, `checksums`, `dependencies`, `size`, `buildfile`,
|
||||
`download` and `signature`.
|
||||
`language`, `version`, `checksums`, `dependencies`, `size`, `buildfile` and
|
||||
`download`.
|
||||
|
||||
The author field is self explainatory, it is simply the authors name and email,
|
||||
formatted similar to git's default format: `Full Name <email@address>`. If the
|
||||
|
@ -66,71 +63,12 @@ means of reproducing the build. This field is purely so people can understand
|
|||
how the image was built, and to make sure you aren't packing any mallicious
|
||||
code into it.
|
||||
|
||||
The download field is a URL pointing to a place of which the package file can
|
||||
The final field is download, this points to a URL of which the package file can
|
||||
be obtained from. If this is a relative url, the baseurl will be appended to
|
||||
it. This is particularly useful if everything is stored within 1 s3 bucket, or
|
||||
you have a repository in a folder.
|
||||
|
||||
The signature field is an armored signature
|
||||
|
||||
|
||||
== Package File ==
|
||||
|
||||
Within a repository, many package files are contained. These files are
|
||||
downloaded and installed into `/piston`. They need to all follow the format
|
||||
as listed below for the API to properly utilize them.
|
||||
|
||||
A package file is a gzipped tar archive, containing 4/5 things - `run`,
|
||||
`compile` (optional), `pkg-info.json`, `lang-ver` and `lang-ver/environment`.
|
||||
Replacing lang-ver with the language name and the version respectively.
|
||||
|
||||
|
||||
The `pkg-info.json` file contains 5 different keys: `language`, `version`,
|
||||
`author`, `dependencies` and `build_platform`.
|
||||
|
||||
The language field is simply the name of the language, all lowercase and not
|
||||
containing any version number. This is important in the case of python
|
||||
specifically as python3 and python2 come under the same language, just
|
||||
different versions.
|
||||
|
||||
The version field is a sem-ver compliant version number for the interpreter
|
||||
contained wthin the package. It should be a string.
|
||||
|
||||
The author field contains the author name, and should be formatted exactly like
|
||||
shown previously in the repo index spec.
|
||||
|
||||
The dependencies field is simply a map containing packages which this package
|
||||
depends on. This should only be used when one language is a requirement for
|
||||
another, like how typescript is dependent on node. The key should be the name
|
||||
of the package, with the value being the version selector.
|
||||
|
||||
The build_platform field is used for defining which type of system the package
|
||||
was built on, this helps resolve system compatability errors. It consists of 2
|
||||
parts - environment and disto. The environment is simply one of `baremetal`,
|
||||
`docker`, `lxc` or any other type of environment you can run piston on. The
|
||||
distro is the ID of the distro as contained in /etc/os-release on the system
|
||||
which built the package. This is done to ensure system compatability,
|
||||
especially inside the offically supported Docker container.
|
||||
|
||||
|
||||
The `run` and `compile` files are used in the execution of a job, being used
|
||||
to both compile and run the source code provided. They are both treated the
|
||||
same inputs-wise but can have timeouts independently set per stage. The
|
||||
arguments fed both these files are the same, with the first argument being a
|
||||
path to the code file, and the rest being the arguments to passed in. These
|
||||
files are run in a temporary directory contained within the cache folder.
|
||||
Depending on the cache control level the code and associated files will either
|
||||
be disposed of or kept. By default only files named `binary` will be kept.
|
||||
STDIN is only passed into the `run` file, but both files have their output
|
||||
captured and returned along with their exit codes through the API
|
||||
|
||||
The `lang-ver` folder should contain any interpreter specific files, such as
|
||||
the binary to execute and any other files that may be required to run the
|
||||
interpreter/compiler contained within the package.
|
||||
|
||||
The `environment` file contained within `lang-ver` should contain export
|
||||
commands like a ~/.bashrc file should, as this is its intended purpose. Firstly
|
||||
the language which is being executed has its environment file sources, then it
|
||||
walks down the dependency tree sourcing files. The environment variables are
|
||||
eventually cached to speed up the execution process.
|
||||
|
||||
TODO
|
|
@ -0,0 +1,3 @@
|
|||
*
|
||||
!**/Makefile
|
||||
!.gitignore
|
|
@ -6,13 +6,11 @@ LANG_COMPILED=$(or ${COMPILED}, false)
|
|||
|
||||
LANG_PKG_TARGETS=pkg-info.json ${LANG_NAME}-${LANG_VERSION}/ ${LANG_NAME}-${LANG_VERSION}/environment run
|
||||
|
||||
BUILD_PLATFORM=$(or ${PLATFORM}, baremetal-$(shell grep -oP "^ID=\K\w+" /etc/os-release ))
|
||||
|
||||
ifeq (${LANG_COMPILED}, true)
|
||||
${LANG_NAME}-${LANG_VERSION}.pkg.tar.gz: $(LANG_PKG_TARGETS) compile
|
||||
endif
|
||||
${LANG_NAME}-${LANG_VERSION}.pkg.tar.gz: $(LANG_PKG_TARGETS)
|
||||
tar czf $@ $?
|
||||
tar czvf $@ $?
|
||||
|
||||
%.json: %.jq
|
||||
jq '$(shell tr '\n' '|' < $<).' <<< "{}" > $@
|
||||
|
@ -22,22 +20,9 @@ pkg-info.jq:
|
|||
echo '.version="${LANG_VERSION}"' >> pkg-info.jq
|
||||
echo '.author="${LANG_AUTHOR}"' >> pkg-info.jq
|
||||
echo '.dependencies={}' >> pkg-info.jq
|
||||
echo '.build_platform="${BUILD_PLATFORM}"' >> pkg-info.jq
|
||||
$(foreach dep, ${LANG_DEPS}, echo '.dependencies.$(word 1,$(subst =, ,${dep}))="$(word 2,$(subst =, ,${dep}))"' >> pkg-info.jq)
|
||||
|
||||
%.asc: %
|
||||
gpg --detach-sig --armor --output $@ $<
|
||||
|
||||
%/: %.tgz
|
||||
tar xzf $<
|
||||
|
||||
.PHONY: clean
|
||||
clean:
|
||||
rm -rf $(filter-out Makefile, $(wildcard *))
|
||||
|
||||
,PHONY: cleanup
|
||||
cleanup:
|
||||
rm -rf $(filter-out ${LANG_NAME}-${LANG_VERSION}.pkg.tar.gz.asc, $(filter-out ${LANG_NAME}-${LANG_VERSION}.pkg.tar.gz, $(filter-out Makefile, $(wildcard *))))
|
||||
|
||||
.PHONY: sign
|
||||
sign: ${LANG_NAME}-${LANG_VERSION}.pkg.tar.gz.asc
|
|
@ -1 +0,0 @@
|
|||
*/
|
|
@ -0,0 +1,28 @@
|
|||
NAME=python
|
||||
VERSION=3.9.1
|
||||
AUTHOR=Thomas Hobson <thomas@hexf.me>
|
||||
DEPS=
|
||||
COMPILED=false
|
||||
|
||||
MAKE_JOBS=64
|
||||
|
||||
include ../../Makefile
|
||||
|
||||
run:
|
||||
echo "python3.9 $*" > run
|
||||
|
||||
python-${VERSION}/environment:
|
||||
echo 'export PATH=$$PWD/python-${VERSION}/bin:$$PATH' > $@
|
||||
|
||||
python-${VERSION}/: Python-${VERSION}/
|
||||
cd $< && ./configure --prefix /
|
||||
make -j${MAKE_JOBS} -C $<
|
||||
DESTDIR=../$@ make -j${MAKE_JOBS} -C $< altinstall || true
|
||||
|
||||
Python-${VERSION}.tgz:
|
||||
curl "https://www.python.org/ftp/python/${VERSION}/$@" -o $@
|
||||
|
||||
%/: %.tgz
|
||||
tar xzvf $<
|
||||
|
||||
|
|
@ -1,24 +0,0 @@
|
|||
LANGUAGE=python
|
||||
VERSIONS=2.7.1 3.9.1
|
||||
|
||||
.PHONY: build sign cleanup clean
|
||||
build: $(patsubst %,%/${LANGUAGE}-%.pkg.tar.gz,${VERSIONS})
|
||||
sign: $(patsubst %,%/${LANGUAGE}-%.pkg.tar.gz.asc,${VERSIONS})
|
||||
clean:
|
||||
rm -rf ${VERSIONS}
|
||||
cleanup: $(patsubst %,%/cleanup,${VERSIONS})
|
||||
|
||||
|
||||
%/cleanup: %/Makefile
|
||||
$(MAKE) -C $(shell dirname $<) cleanup
|
||||
rm $(shell dirname $<)/Makefile
|
||||
|
||||
%/${LANGUAGE}-%.pkg.tar.gz.asc: %/Makefile
|
||||
$(MAKE) -C $(shell dirname $<) sign
|
||||
%/${LANGUAGE}-%.pkg.tar.gz: %/Makefile
|
||||
$(MAKE) -C $(shell dirname $<)
|
||||
|
||||
%/Makefile:
|
||||
@mkdir -p $(shell dirname $@)
|
||||
@echo 'VERSION=$(patsubst %/Makefile,%,$@)' > $@
|
||||
@echo 'include ../base.mk' >> $@
|
|
@ -1,21 +0,0 @@
|
|||
NAME=python
|
||||
AUTHOR=Thomas Hobson <thomas@hexf.me>
|
||||
DEPS=
|
||||
#VERSION=
|
||||
COMPILED=false
|
||||
|
||||
include ../../common.mk
|
||||
|
||||
run:
|
||||
echo 'python$(shell grep -oP "\d+.\d+"<<<${VERSION}) $$*' > run
|
||||
|
||||
python-${VERSION}/environment:
|
||||
echo 'export PATH=$$PWD/${NAME}-${VERSION}/bin:$$PATH' > $@
|
||||
|
||||
python-${VERSION}/: Python-${VERSION}/
|
||||
cd $< && ./configure --prefix /
|
||||
$(MAKE) -j$(or ${MAKE_JOBS},64) -C $<
|
||||
DESTDIR=../$@ $(MAKE) -j$(or ${MAKE_JOBS},64) -C $< altinstall || true
|
||||
|
||||
Python-${VERSION}.tgz:
|
||||
curl "https://www.python.org/ftp/python/${VERSION}/$@" -o $@
|
Loading…
Reference in New Issue