Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Kong/homebrew-kong
:monkey: Homebrew tap for Kong
https://github.com/Kong/homebrew-kong
archived deprecated obsolete
Last synced: 28 days ago
JSON representation
:monkey: Homebrew tap for Kong
- Host: GitHub
- URL: https://github.com/Kong/homebrew-kong
- Owner: Kong
- Archived: true
- Created: 2015-04-15T23:55:14.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-04-06T11:10:56.000Z (over 1 year ago)
- Last Synced: 2024-08-04T04:05:13.691Z (4 months ago)
- Topics: archived, deprecated, obsolete
- Language: Ruby
- Homepage: https://getkong.org
- Size: 160 KB
- Stars: 69
- Watchers: 34
- Forks: 35
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-kong - Homebrew - Homebrew Formula for Kong (Tools / Distributions)
README
# DEPRECATED
[](http://unmaintained.tech/)
The Kong homebrew formula is no longer supported, please consider using Docker instead for local development:
https://hub.docker.com/_/kong
# Homebrew Kong Tap
Homebrew tap for [Kong] :beer:
> Kong is a scalable and customizable API Management Layer built on top of
> Nginx.
## Install (stable)
```shell
$ brew tap kong/kong
==> Tapping kong/kong
Cloning into '/usr/local/Homebrew/Library/Taps/kong/homebrew-kong'...
$ brew install kong
==> Downloading https://github.com/Kong/kong-build-tools/archive/4.22.0.tar.gz
==> Downloading https://download.konghq.com/gateway-src/kong-2.8.1.tar.gz
```
## Options
### Install HEAD (unstable)
HEAD points to Kong's `next` branch, the development branch for cutting edge
installs:
```shell
$ brew install --HEAD kong
==> Downloading https://github.com/Kong/kong-build-tools/archive/4.22.0.tar.gz
==> Downloading from https://codeload.github.com/Kong/kong-build-tools/tar.gz/refs/tags/4.22.0
==> Cloning https://github.com/Kong/kong.git
Cloning into '/Users/if/Library/Caches/Homebrew/kong--git'...
==> Checking out branch master
==> Installing kong from kong/kong
```
### Removing the Tap
```shell
$ brew untap kong/kong
Untapping kong/kong...
Untapped 6 formulae (23 files, 198.8KB).
```
## Developing Formulae
### Use a branch/tag of this tap
Developing formulae can be eased by setting a git ref (branch/tag) for the entire tap. This can be accomplished by tapping the tap, then using `git checkout` to arrive at the desired ref (for all formulae):
```shell
$ brew tap kong/kong
==> Tapping kong/kong
$ cd /usr/local/Homebrew/Library/Taps/kong/homebrew-kong
Note: In Monterey it is /opt/homebrew/Library/Taps/kong/homebrew-kong
$ git checkout release/3.0.0
Branch 'release/3.0.0' set up to track remote branch 'release/3.0.0' from 'origin'.
Switched to a new branch 'release/3.0.0'
$ brew install kong
==> Downloading https://github.com/Kong/kong-build-tools/archive/4.33.10.tar.gz
==> Downloading https://download.konghq.com/gateway-src/kong-3.0.0.tar.gz
==> Installing kong from kong/kong
==> Installing dependencies for kong/kong/kong: kong/kong/[email protected]
==> Installing kong/kong/kong dependency: kong/kong/[email protected]
```
Get the full output from the `kong-ngx-build` script by using the `--verbose` flag when installing:
```shell
$ brew install --verbose kong
==> ./kong-ngx-build --prefix /usr/local/Cellar/[email protected]/1.21.4.1 --openresty 1.21.4.1 --openssl 1.1.1q --luarocks 3.9.1 --pcre 8.45 -j 12
NOTICE: Downloading the components now...
/private/tmp/openrestyA1.21.4.1-20220913-30100-7mtl7u/kong-build-tools-4.33.10/openresty-build-tools/work /private/tmp/openrestyA1.21.4.1-20220913-30100-7mtl7u/kong-build-tools-4.33.10/openresty-build-tools
WARN: OpenSSL source not found, downloading...
NOTICE: Downloaded: d7939ce614029cdff0b6c20f0e2e5703158a489a72b2507b8bd51bf8c8fd10ca openssl-1.1.1q.tar.gz
```
Run the tests that live in the formulae (after installing them):
```shell
$ brew test --verbose kong
==> Testing kong/kong/kong
/usr/local/Homebrew/Library/Homebrew/test.rb (Formulary::FromPathLoader): loading /usr/local/Homebrew/Library/Taps/kong/homebrew-kong/Formula/kong.rb
==> /usr/local/Cellar/kong/3.0.0/bin/kong version -vv 2>&1 | grep 'Kong:'
2022/09/13 11:42:04 [verbose] Kong: 3.0.0
==> kong config init /private/tmp/tmp.DYgJNwy8Xa
==> kong check /private/tmp/tmp.DYgJNwy8Xa
configuration at /private/tmp/tmp.DYgJNwy8Xa
is valid
```
## Use Kong
```shell
$ KONG_DATABASE=off kong start
Kong started
```
Get started by reading the documentation at: [https://docs.konghq.com](https://docs.konghq.com)
[kong]: https://konghq.com