docs: simple access check guide (#451)

This also enables gRPC go, gRPC nodejs, cURL, and Keto CLI code samples to be tested.

.circleci/config.yml

@@ -7,13 +7,13 @@ orbs:
   slack: circleci/[email protected]
   nancy: ory/[email protected]
   docs: ory/[email protected]
-  golangci: ory/[email protected].9
+  golangci: ory/[email protected].13
 
 jobs:
   test:
     docker:
       -
-        image: circleci/golang:1.15
+        image: cimg/go:1.15-node
         environment:
           TEST_DATABASE_POSTGRESQL: postgres://test:test@localhost:5432/keto?sslmode=disable
           TEST_DATABASE_MYSQL: mysql://root:test@(localhost:3306)/mysql?parseTime=true&multiStatements=true
@@ -31,10 +31,10 @@ jobs:
       -
         image: cockroachdb/cockroach:v20.2.4
         command: start-single-node --insecure
-    working_directory: /go/src/github.com/ory/keto
     steps:
       - checkout
       - setup_remote_docker
+      - run: sudo npm i -g npm@7
       # Installation
       -
         run: go mod verify
@@ -52,16 +52,20 @@ jobs:
       # Submit coverage details
       -
         run: test -z "$CIRCLE_PR_NUMBER" && goveralls -service=circle-ci -coverprofile=coverage.txt -repotoken=$COVERALLS_REPO_TOKEN || echo "forks are not allowed to push to coveralls"
+
+      # Test documentation examples
+      -
+        run: make test-docs-samples
   validate:
     docker:
-      - image: circleci/golang:1.15-node
+      - image: cimg/go:1.15-node
         environment:
           GO111MODULE: 'on'
-    working_directory: /go/src/github.com/ory/keto
     steps:
       - checkout
       - golangci/lint
       - docs/check-format
+      - run: npm ci && npm run format:check
 
 workflows:
   version: 2

Makefile

@@ -21,7 +21,6 @@ ifneq ("$(shell base64 Makefile) $(shell base64 go.mod) $(shell base64 go.sum)",
 		go build -o .bin/buf github.com/bufbuild/buf/cmd/buf
 		go build -o .bin/protoc-gen-go google.golang.org/protobuf/cmd/protoc-gen-go
 		go build -o .bin/protoc-gen-go-grpc google.golang.org/grpc/cmd/protoc-gen-go-grpc
-		npm i -g [email protected]
 		npm i
 		echo "v0" > .bin/.lock
 		echo "$$(base64 Makefile) $$(base64 go.mod) $$(base64 go.sum)" > .bin/.lock
@@ -99,3 +98,11 @@ reset-testdb:
 .PHONY: test-e2e
 test-e2e:
 		go test -tags sqlite -failfast -v ./internal/e2e
+
+.PHONY: test-docs-samples
+test-docs-samples:
+		cd ./contrib/docs-code-samples \
+		&& \
+		npm i \
+		&& \
+		npm test

buf.gen.yaml

@@ -12,7 +12,7 @@ plugins:
   - name: js-grpc
     out: proto
     opt: grpc_js,binary,import_style=commonjs
-    path: grpc_tools_node_protoc_plugin
+    path: node_modules/.bin/grpc_tools_node_protoc_plugin
   - name: ts
     out: proto
     opt: ts_out=proto

contrib/cat-videos-example/docker-compose.yml

@@ -4,10 +4,9 @@ services:
   keto:
     image: oryd/keto:latest
     ports:
-      - "4466:4466"
-      - "4467:4467"
-    command:
-      serve -c /home/ory/keto.yml
+      - '4466:4466'
+      - '4467:4467'
+    command: serve -c /home/ory/keto.yml
     restart: on-failure
     volumes:
       - type: bind
@@ -22,6 +21,5 @@ services:
       - type: bind
         source: .
         target: /home/ory
-    command:
-      relation-tuple create /home/ory/relation-tuples
+    command: relation-tuple create /home/ory/relation-tuples
     restart: on-failure

contrib/docs-code-samples/.gitignore

@@ -0,0 +1 @@
+*.log