Sign inSign up

stackify/retrace-arm64

By stackify

•Updated 2 months ago

Image
0

2.3K

stackify/retrace-arm64 repository overview

⁠Stackify Retrace Container

The Stackify Retrace Container helps with installing Retrace in docker container setups where you are unable to install the Stackify Linux Agent on the Docker host systems.

⁠Kubernetes Setup Walkthrough

⁠Setup DaemonSet for Stackify Retrace Container.
  • Replace YOUR_ACTIVATION_KEY, YOUR_ENVIRONMENT_NAME and YOUR_KUBERNETES_CLUSTER_NAME.
  • image: stackify/retrace-arm64 may need to be updated to point to your own repository.

---
apiVersion: v1
kind: ServiceAccount
metadata:
  name: stackify
  namespace: default
automountServiceAccountToken: true
---
apiVersion: rbac.authorization.k8s.io/v1beta1
kind: ClusterRole
metadata:
  name: stackify
rules:
- apiGroups: [""]
  resources:
    - "pods"
    - "services"
  verbs: ["get", "list"]
---
apiVersion: rbac.authorization.k8s.io/v1beta1
kind: ClusterRoleBinding
metadata:
  name: stackify
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: stackify
subjects:
- kind: ServiceAccount
  name: stackify
  namespace: default
---
apiVersion: extensions/v1beta1
kind: DaemonSet
metadata:
  name: stackify-retrace
spec:
  template:
    metadata:
      labels:
        app: stackify-retrace
    spec:
      serviceAccountName: stackify
      containers:
        - name: stackify-retrace
          image: stackify/retrace-arm64
          securityContext:
            runAsUser: 0
          env:
            - name: STACKIFY_KEY
              value: "YOUR_ACTIVATION_KEY"
            - name: STACKIFY_ENV
              value: "YOUR_ENVIRONMENT_NAME"
            - name: STACKIFY_K8S_CLUSTER_NAME
              value: "YOUR_KUBERNETES_CLUSTER_NAME"
          volumeMounts:
            - name: hostfs
              mountPath: /hostfs
              readOnly: true
            - name: stackify
              mountPath: /var/stackify
              readOnly: false
      volumes:
        - name: hostfs
          hostPath:
            path: /
        - name: stackify
          hostPath:
            path: /var/stackify
            type: DirectoryOrCreate
⁠Troubleshooting
⁠Google Cloud

Ensure that your user has permissions to create a ServiceAccount.

kubectl create clusterrolebinding cluster-admin-binding --clusterrole=cluster-admin --user $(gcloud config get-value account)

⁠Setup Application Pods

Setup the appropriate Stackify Profiler for your application.

Note: Disregard the Install Retrace Step.

Adjust your application pod configuration to include the stackify volume and volumeMounts sections.

For each pod define the stackify volume:

volumes:
  - name: stackify
    hostPath: 
      path: /var/stackify
      type: DirectoryOrCreate

For each container define a volumeMount to the stackify volume:

volumeMounts:
  - mountPath: /usr/local/stackify
    name: stackify

Example pod configuration:

apiVersion: v1
kind: ReplicationController
metadata:
  name: pod-name
spec:
  replicas: 1
  selector:
    app: app-name
  template:
    metadata:
      name: template-name
      labels:
        app: app-name
    spec:
      containers:
      - name: container-name
        image: application-image
        volumeMounts:
          - mountPath: /usr/local/stackify
            name: stackify
      volumes:
        - name: stackify
          hostPath: 
            path: /var/stackify
            type: DirectoryOrCreate
⁠Verify

Make requests against your application; verify results in the Retrace dashboard.

⁠Docker Setup Walkthrough

⁠Add Stackify Volume

Add a stackify volume.

docker volume create stackify
⁠Start Stackify Retrace Container
docker run -d --restart always \
 -e "STACKIFY_KEY=YOUR_ACTIVATION_KEY" \
 -e "STACKIFY_ENV=YOUR_ENVIRONMENT_NAME" \
 -v stackify:/var/stackify \
 -v /:/hostfs:ro \
 --user 0:0 \
 stackify/retrace-arm64:latest 

Note: Replace YOUR_ACTIVATION_KEY and YOUR_ENVIRONMENT_NAME.

⁠Start Application Container

Setup the appropriate Stackify Profiler for your application.

Note: Disregard the Install Retrace Step.

Configure you Application Container to include the stackify volume.

docker run -v stackify:/usr/local/stackify [application-image]
⁠Verify

Make requests against your application; verify results in the Retrace dashboard.

Tag summary

Content type

Image

Digest

sha256:ec503c9de…

Size

446.6 MB

Last updated

2 months ago

docker pull stackify/retrace-arm64