chore: add detailed information about dice example, add source for al…

…l shell scripts from docs

Signed-off-by: Igor Eulalio <[email protected]>

examples/dice/README.md

@@ -1,6 +1,8 @@
 # Dice example
 
-Instructions on how to run instrumented and uninstrumented examples.
+This is the foundation example for [Getting Started](https://opentelemetry.io/docs/languages/go/getting-started/) with OpenTelemetry.
+
+Below, you will see instructions on how to run this application, either with or without instrumentation.
 
 ## Usage
 

examples/dice/instrumented/.tool-versions

@@ -0,0 +1 @@
+golang 1.22.0

examples/dice/instrumented/get.sh

@@ -0,0 +1,17 @@
+# Copyright The OpenTelemetry Authors
+# SPDX-License-Identifier: Apache-2.0
+
+#!/bin/bash
+
+go get "go.opentelemetry.io/otel" \
+  "go.opentelemetry.io/otel/exporters/stdout/stdoutmetric" \
+  "go.opentelemetry.io/otel/exporters/stdout/stdouttrace" \
+  "go.opentelemetry.io/otel/exporters/stdout/stdoutlog" \
+  "go.opentelemetry.io/otel/sdk/log" \
+  "go.opentelemetry.io/otel/log/global" \
+  "go.opentelemetry.io/otel/propagation" \
+  "go.opentelemetry.io/otel/sdk/metric" \
+  "go.opentelemetry.io/otel/sdk/resource" \
+  "go.opentelemetry.io/otel/sdk/trace" \
+  "go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp"\
+  "go.opentelemetry.io/contrib/bridges/otelslog"

examples/dice/instrumented/init.sh

@@ -0,0 +1,6 @@
+# Copyright The OpenTelemetry Authors
+# SPDX-License-Identifier: Apache-2.0
+
+#!/bin/bash
+
+module go.opentelemetry.io/contrib/examples/dice/instrumented

examples/dice/instrumented/run.sh

@@ -0,0 +1,8 @@
+# Copyright The OpenTelemetry Authors
+# SPDX-License-Identifier: Apache-2.0
+
+#!/bin/bash
+
+go mod tidy
+export OTEL_RESOURCE_ATTRIBUTES="service.name=dice,service.version=0.1.0"
+go run .

examples/dice/instrumented/tidy.sh

@@ -0,0 +1,6 @@
+# Copyright The OpenTelemetry Authors
+# SPDX-License-Identifier: Apache-2.0
+
+#!/bin/bash
+
+go mod tidy

examples/dice/run.sh

@@ -14,17 +14,14 @@ case "$1" in
   instrumented)
     echo "Running instrumented example..."
     cd instrumented || exit
-    go mod tidy
+    source tidy.sh
     go mod download
-    export OTEL_RESOURCE_ATTRIBUTES="service.name=dice,service.version=0.1.0"
-    go run .
+    source run.sh
     ;;
   uninstrumented)
     echo "Running uninstrumented example..."
     cd uninstrumented || exit
-    go mod tidy
-    go mod download
-    go run .
+    source run.sh
     ;;
   *)
     echo "Invalid argument: $1. Use 'instrumented' or 'uninstrumented'."

examples/dice/uninstrumented/run.sh

@@ -0,0 +1,6 @@
+# Copyright The OpenTelemetry Authors
+# SPDX-License-Identifier: Apache-2.0
+
+#!/bin/bash
+
+go run .