Sign inSign up

estoesmoises/stackoverflow-backstage-demo

By estoesmoises

•Updated 5 days ago

A development backstage environment configured to use the integration with Stack Overflow for Teams.

Image
0

1.9K

estoesmoises/stackoverflow-backstage-demo repository overview

⁠📦 Backstage instance with Stack Overflow for Teams integration

If you’d like to quickly test how the Stack Overflow for Teams integration works inside Backstage — without having to set up your own Backstage environment — you can use this pre-built Docker image:

Image: estoesmoises/stackoverflow-backstage-demo:latest

This image runs a Backstage instance pre-configured with the Stack Overflow for Teams plugin. You only need to pass a few environment variables when starting the container to hook it up to your Stack Overflow for Teams instance.

⁠📦 Required Environment Variables

⁠For Enterprise Customers:
VariableDescription
STACK_OVERFLOW_INSTANCE_URLThe base URL of your Stack Overflow for Teams (Enterprise) instance.
STACK_OVERFLOW_API_ACCESS_TOKENA read-only, no-expiry API access token generated for your Stack Overflow Enterprise instance. This token is used by the plugin’s search collator to index questions into Backstage search.
STACK_OVERFLOW_CLIENT_IDThe OAuth Client ID from your Stack Overflow application. This is required to enable the secure question creation flow from within Backstage.
STACK_OVERFLOW_REDIRECT_URIThe redirect URI where Stack Overflow should send users after completing the OAuth authentication flow. By default, this is {app.baseUrl}/stack-overflow-teams. For local development, you can use a redirect service like http://redirectmeto.com/http://localhost:7007/stack-overflow-teams.
⁠For Basic and Business Customers:
VariableDescription
STACK_OVERFLOW_TEAM_NAMEThe team name or team slug from your Stack Overflow for Teams account.
STACK_OVERFLOW_API_ACCESS_TOKENA read-only, no-expiry API access token generated for your Stack Overflow Teams instance. Used for indexing content.

Note:
Question creation is not supported on the Basic tier.

📖 How to generate your API Access Token

Basic and Business customers can follow the official Stack Overflow for Teams guide to create a Personal Access Token (PAT) for API authentication:

👉 Personal Access Tokens (PATs) for API Authentication⁠

This token should have read-only access and no expiration to be used for indexing questions into Backstage search.

⁠🐳 Example Docker Run Command

docker run -p 7007:7007 \
  -e STACK_OVERFLOW_INSTANCE_URL=https://support-autotest.stackenterprise.co \
  -e STACK_OVERFLOW_API_ACCESS_TOKEN='CasdasdasdaDQyrqdfQ))' \
  -e STACK_OVERFLOW_CLIENT_ID=19 \
  -e STACK_OVERFLOW_REDIRECT_URI=http://redirectmeto.com/http://localhost:7007/stack-overflow-teams \
  estoesmoises/stackoverflow-backstage-demo:latest

Once running, the Backstage app will be accessible at http://localhost:7007⁠

Tag summary

Content type

Image

Digest

sha256:261365fe3…

Size

287.8 MB

Last updated

5 days ago

docker pull estoesmoises/stackoverflow-backstage-demo