Repository files navigation

Software engineers at ETHR previously used a variation of the following project as a playground for softwaredevelopment, automation testing, research, and for demonstrating proof-of-concepts.

This playground was the motivation behind establishingx-ethr and its related open-source repositories.

The Playground's Deployed Service Mesh

• MacOS with Administrative Privileges
• go
• cloud-provider-kind
• Homebrew
• Kind
• kubectl
• Docker Desktop
• istioctl
• ethr-cli
• flux
• psql

• OpenLens - Kubernetes UI Dashboard

1. Installkind.

   go install sigs.k8s.io/kind@latestsudo install"$(go env --json| jq -r".GOPATH")/bin/kind" /usr/local/bin

2. Create a cluster viakind.

   kind create cluster --config"configuration.yaml"kubectl config set-context"$(printf"%s-kind""kind")"

3. Unable node(s).

   kubectl label node kind-control-plane node.kubernetes.io/exclude-from-external-load-balancers-

4. Setup a local load-balancer (within its own private terminal session).

   go install sigs.k8s.io/cloud-provider-kind@latestsudo install"$(go env --json| jq -r".GOPATH")/bin/cloud-provider-kind" /usr/local/bincloud-provider-kind -v 9

5. Verify connectivity to the cluster.
   • If using OpenLens, select thekind-kind context.
6. Bootstrap.

   flux bootstrap github --repository"https://github.com/x-ethr/cluster-management" \    --owner"x-ethr" \    --private"false" \    --personal"false" \    --path"clusters/local" \    --verbose

   • Requires a validGitHubpersonal access tokenset as environment variables:GITHUB_TOKEN.
   • For users outside thex-ethr organization, fork, import, or copythehttps://github.com/x-ethr/cluster-management repository; or use a customized Flux GitOps project.
7. Sync local cluster repository'svendors.

   git submodule update --remote --recursive

8. Addkustomization.yaml to new cluster directory (only applicable during first-time cluster setup).

   cat<<EOF > ./vendors/cluster-management/clusters/local/kustomization.yamlapiVersion: kustomize.config.k8s.io/v1beta1kind: Kustomizationresources: []EOF

9. Optionally, update theKustomization.flux-system.spec.interval (changes each time a local cluster is bootstrapped).
10. Push local changes tovendors submodules.

    git submodule foreach"git add . && git commit --message\"Git Submodule Update(s)\" && git push -u origin HEAD:main"

11. Start the local registry.

    bash ./scripts/registry.bash

12. Wait for the various resources to reconcile successfully.

The following command will port-forward the gateway's configured port80 and expose it onlocalhost:8080.

kubectl port-forward --namespace development services/gateway 8080:80

In order to view tracing and network traffic, issue the following command(s):

foriin$(seq 1 250);do    curl"http://localhost:8080/v1/test-service-1"    curl"http://localhost:8080/v1/test-service-2"    curl"http://localhost:8080/v1/test-service-2/alpha"        curl"http://localhost:8080/v1/authentication"done

The following command will expose thekiali service and open a browser to its dashboard.

istioctl dashboard kiali

The following command will expose thejaeger service and open a browser to its dashboard.

istioctl dashboard jaeger

Usefulistoctl command(s)

kubectl -n istio-system logs --since=1h istiod-6bc5bc58b4-wvhmc --follow

Usefulkubectl command(s)

Logging

kubectl --namespace caching logs --since=10m services/redis --follow

Usefulredis-cli command(s)

redis-cli

Add consumer to consumer group

xadd demo-stream* name john email jdoe@test.comxadd demo-stream* tom tom@test.com

Please see theContributing Guide file for additional details.

kubectl get --namespace istio-system svc/ingress-gateway -o=jsonpath='{.status.loadBalancer.ingress[0].ip}'

Restart the Istio API Gateway Deployment

• Official Schema Store
  • OpenAPI 3.1
  • OpenAPI 3.0
• AWS EKS, Crossplane, Flux Sample
  • Blog Reference
• Istio By Example
• Distributed Tracing
• Slog Guide
• Tokens & Microservice(s)
• Golang Reverse Proxy
• JWKS
• CoreOS OIDC
• Example of Microservice Communication
• Redis Message Broker
• Kubernetes & Redis
• Redis Streams