113 lines
5.7 KiB
Markdown
113 lines
5.7 KiB
Markdown
# @shipzone/npmci
|
|
node and docker in gitlab ci on steroids
|
|
|
|
## Availabililty and Links
|
|
* [npmjs.org (npm package)](https://www.npmjs.com/package/@shipzone/npmci)
|
|
* [gitlab.com (source)](https://gitlab.com/shipzone/npmci)
|
|
* [github.com (source mirror)](https://github.com/shipzone/npmci)
|
|
* [docs (typedoc)](https://shipzone.gitlab.io/npmci/)
|
|
|
|
## Status for master
|
|
|
|
Status Category | Status Badge
|
|
-- | --
|
|
GitLab Pipelines | [](https://lossless.cloud)
|
|
GitLab Pipline Test Coverage | [](https://lossless.cloud)
|
|
npm | [](https://lossless.cloud)
|
|
Snyk | [](https://lossless.cloud)
|
|
TypeScript Support | [](https://lossless.cloud)
|
|
node Support | [](https://nodejs.org/dist/latest-v10.x/docs/api/)
|
|
Code Style | [](https://lossless.cloud)
|
|
PackagePhobia (total standalone install weight) | [](https://lossless.cloud)
|
|
PackagePhobia (package size on registry) | [](https://lossless.cloud)
|
|
BundlePhobia (total size when bundled) | [](https://lossless.cloud)
|
|
Platform support | [](https://lossless.cloud) [](https://lossless.cloud)
|
|
|
|
## Usage
|
|
|
|
Use TypeScript for best in class instellisense.
|
|
|
|
npmci is designed to work in docker CI environments. The following docker images come with npmci presinstalled:
|
|
|
|
Docker Hub:
|
|
|
|
- [hosttoday/ht-docker-node:npmci](https://hub.docker.com/r/hosttoday/ht-docker-node/)
|
|
has LTS node version and npmci preinstalled.
|
|
- [hosttoday/ht-docker-dbase](https://hub.docker.com/r/hosttoday/ht-docker-dbase/)
|
|
based on docker:git, can be used to build docker images in conjunction with docker:dind
|
|
|
|
npmci can be called from commandline and handle a lot of tasks durug ci:
|
|
|
|
```shell
|
|
# Handle node versions
|
|
npmci node install stable # will install latest stable node version and update PATH for node and npm
|
|
npmci node install lts # will install latest LTS node version and update PATH for node and npm versions
|
|
npmci node install legacy # will install latest legacy node version and update PATH for node and npm
|
|
npmci node install x.x.x # will install any specific node version.
|
|
|
|
# Handle npm and yarn tasks
|
|
npmcu npm login # logs in npm using the auth key provided at env var "NPMCI_TOKEN_NPM"
|
|
npmci npm install # installs dependencies using npm or yarn dependending on availablity
|
|
npmci npm test # tests the package
|
|
npmci npm publish # builds a package and publishes it
|
|
|
|
# handle docker tasks
|
|
npmci docker prepare
|
|
## npmci test docker will look at all Dockerfiles and look for according tags on GitLab container registry
|
|
|
|
|
|
# prepare tools
|
|
npmci prepare npm # will look for $NPMCI_TOKEN_NPM env var and create .npmrc, so npm is authenticated
|
|
npmci prepare docker # will look for $NPMCI_LOGIN_DOCKER in form username|password and authenticate docker
|
|
npmci prepare docker-gitlab # will authenticate docker for gitlab container registry
|
|
|
|
# build containers
|
|
npmci docker build # will build containers
|
|
## all Dockerfiles named Dockerfile* are picked up.
|
|
## specify tags like this Dockerfile_[tag]
|
|
## uploads all built images as [username]/[reponame]:[tag]_test to GitLab
|
|
## then test in next step with "npmci test docker"
|
|
|
|
# publish npm module
|
|
npmci publish npm # will look vor $NPMCI_TOKEN_NPM env var and push any module in cwd to npm
|
|
npmci publish docker
|
|
|
|
# trigger webhooks
|
|
npmci trigger # will look for NPMCI_TRIGGER_1 to NPMCI_TRIGGER_100 in form domain|id|token|ref|name
|
|
```
|
|
|
|
## Configuration
|
|
|
|
npmci supports the use of npmextra.
|
|
|
|
To configure npmci create a `npmextra.json` file at the root of your project
|
|
|
|
```json
|
|
{
|
|
"npmci": {
|
|
"globalNpmTools": ["npm-check-updates", "protractor", "npmts", "gitzone"]
|
|
}
|
|
}
|
|
```
|
|
|
|
**Available options**
|
|
|
|
| setting | example | description |
|
|
| -------------- | ----------------------------- | ------------------------------------------------------------------------------------------------- |
|
|
| globalNpmTools | "globalNpmTools": ["gitbook"] | Will look for the specified package names locally and (if not yet present) install them from npm. |
|
|
|
|
For further information read the linked docs at the top of this README.
|
|
|
|
Use TypeScript for best in class instellisense.
|
|
|
|
## Contribution
|
|
|
|
We are always happy for code contributions. If you are not the code contributing type that is ok. Still, maintaining Open Source repositories takes considerable time and thought. If you like the quality of what we do and our modules are useful to you we would appreciate a little monthly contribution: You can [contribute one time](https://lossless.link/contribute-onetime) or [contribute monthly](https://lossless.link/contribute). :)
|
|
|
|
For further information read the linked docs at the top of this readme.
|
|
|
|
> MIT licensed | **©** [Lossless GmbH](https://lossless.gmbh)
|
|
| By using this npm module you agree to our [privacy policy](https://lossless.gmbH/privacy)
|
|
|
|
[](https://maintainedby.lossless.com)
|