flxbl docs
slackGitHub
  • flxbl
  • sfp
  • sfops
  • Overview
  • Getting Started
    • Pre-Requisites
    • Install sfp
    • Configure Your Project
    • Build & Install an Artifact
    • Congratulations!
    • Docker Images
      • sfp-pro
  • CONCEPTS
    • Overview
    • SF CLI vs. SFP
    • Domains
    • Packages
    • Supported package types
      • Unlocked Packages
      • Org-Dependent Unlocked Packages
      • Source Packages
      • Diff Package
      • Data Packages
    • Artifacts
    • Package vs Artifacts
    • Identifying types of a package
    • Dependency management
    • Transitive Dependency Resolution
    • Destructive Changes
  • configuring a project
    • Project structure
    • Setup Salesforce Org
    • Creating a package
    • Defining a domain
    • Release Config
  • BUILDING ARTIFACTS
    • Overview
    • Determining whether an artifact need to be built
    • Building a domain
    • Building an artifact for package individually
    • Limiting artifacts to be built
    • Controlling aspects of the build command
      • Ignoring packages from being built
      • Building a collection of packages together
      • Selective ignoring of components from being built
      • Use of multiple config file in build command
    • Configuring installation behaviour of a package
      • Always deploy a package
      • Skip Install on Certain Orgs
      • Optimized Installation
      • Pre/Post Deployment Script
      • Reconciling Profiles
      • PermissionSet Assignment
      • Updating Picklist
      • Entitlement Deployment Helper
      • Field History & Feed Tracking
      • Aliasfy Packages
        • Aliasfy Packages - Merge Mode
      • State management for Flows
  • Installing an artifact
    • Overview
    • Controlling Aspects of Installation
    • Applying attributes of an artifact
    • BuiltIn Deployment Helpers
      • PermissionSet Group Awaiter
  • publishing and fetching artifacts
    • Publish Artifact
    • Fetching Artifacts
  • Releasing artifacts
    • Overview
    • Release Definitions
    • Generating a release definition
    • Generating a changelog
  • Validating a change
    • Overview
    • Different types of validation
    • Limiting Validation by Domain
    • Controlling validation attributes of a package
      • Skip Testing
      • Skip Coverage Validation
      • Test Synchronously
  • Analysing a Project
    • Overview
    • Duplicate Check
  • Environment Management
    • Pools
      • Scratch Org Pools
        • Defining a pool
        • Setting up your Salesforce Org for Scratch Org Pools
        • Pool Operations
          • Preparing pools
            • Handling dependencies
          • List Scratch Orgs in a pool
          • Fetch a scratch org
          • Delete Pools
      • Sandbox Pools
        • Sandbox Pool Initialization
        • Fetch a Sandbox from Pool
        • Monitor Sandbox Pools
    • Review Environments
      • Commands
        • Fetch a Review Environment
        • Check Review Environment Status
        • Extend a Review Environment
        • Transition Review Environment Status
        • Unassign a Review Environment
      • Considerations
    • Sandbox
      • Create Sandbox
      • Delete Sandbox
      • List Sandbox
      • Login to Sandbox
      • Update Sandbox
  • Development
    • Development Environment
    • Pull Changes from your org
    • Push Changes to your org
    • Dependency Management
      • Expand Dependencies
      • Shrink Dependencies
      • Explain Dependencies
  • Running sfp as a server
    • Introduction
    • sfp-pro-server: Architecture Overview (Alpha)
      • Task Processing System
      • Authentication & Security Architecture
      • Authentication System: Deep Dive
      • Database Architecture
      • Network Architecture and Integration System
      • Integration Architecture: Building Extensions
    • Installing SFP Server
    • Initializing SFP server
  • API Reference
    • Health
    • Authentication
    • Token
    • Salesforce
    • Team
    • Users
    • Tasks
    • Key Value
    • Repository
    • WebHooks
  • Metrics
    • Available Metrics
    • Custom Metrics
    • Configuring Collectors
      • Datadog
      • Splunk
      • New Relic
      • StatsD
  • Helpers
    • Managing Shared Resources
  • Command Guide
    • Core
      • Build
      • Quickbuild
      • Publish
      • Install
      • Release
    • Advanced
      • Validate
      • Artifacts
      • Changelog
      • Impact
      • Pool
      • Metrics
      • Repo
    • Utilities
      • Apex Tests
      • Flow
      • Dependency
      • Profile
  • FAQs
    • Common Errors
      • Org Shapes
      • Troubleshooting Unlocked Packages Build Failure Due to Code Coverage
    • Common Questions
      • Email Templates Deployment: Classic vs Lightning
      • Dealing with Long Build Times in Salesforce
      • Standard ValueSets and unlocked packages
      • Common Issues encountered with aliasfied packages
      • API Version
      • Understanding alwaysDeploy and skipIfAlreadyInstalled in Deployment Pipelines
    • sfp versioning and upgrade Process
  • References
  • Legal
    • Terms of Service for sfp
    • Terms of Service for 'sfp-pro' Software
  • LLMs.txt
Powered by GitBook
On this page
  • Prerequisites
  • Accessing the Images
  • Best Practices
  • Building Docker Images
  • Support
  1. Getting Started
  2. Docker Images

sfp-pro

SFP-Pro provides Docker images through our self-hosted Gitea registry at source.flxbl.io. These pre-built images are maintained and updated regularly with the latest features and security patches.

Prerequisites

  1. Access to source.flxbl.io (Gitea server)

  2. Docker installed on your machine

  3. Registry credentials from your welcome email

Accessing the Images

  1. Login to the Gitea registry:

docker login source.flxbl.io -u your-username
  1. Pull the desired image:

The version numbers can be found at https://source.flxbl.io/flxbl/-/packages/container/sfp-pro/

# For base sfp-pro image
docker pull source.flxbl.io/sfp-pro:version

# For sfp-pro with SF CLI
docker pull source.flxbl.io/sfp-pro-sf-cli:version
  1. (Optional) Tag for your registry:

# Tag for your registry
docker tag source.flxbl.io/sfp-pro:version your-registry/sfp-pro:version

# Push to your registry
docker push your-registry/sfp-pro:version

Best Practices

  1. Use specific version tags in production

  2. Cache images in your private registry for better performance

  3. Implement proper access controls in your registry

  4. Document image versions used in your pipelines

Building Docker Images

If you need to build the images yourself, you can access the source code from source.flxbl.io and follow these instructions:

Prerequisites

  • Docker with BuildKit support

  • GitHub Personal Access Token with packages:read permissions

  • Node.js (for local development)

Building the Main Image

# Create a file containing your  GITEA token
echo "YOUR_GITEA_TOKEN" > .npmrc.token

# Build the image
docker buildx build \
  --secret id=npm_token,src=.npmrc.token \
  --build-arg NODE_MAJOR=22 \
  -f dockerfiles/sfp-pro.Dockerfile \
  -t sfp-pro:local .

# Remove the token file
rm .npmrc.token

Building the SF CLI Image

# Create a file containing your GitHub NPM token
echo "YOUR_GITEA_TOKEN" > .npmrc.token

# Build the image
docker buildx build \
  --secret id=npm_token,src=.npmrc.token \
  --build-arg NODE_MAJOR=22 \
  -f dockerfiles/sfp-pro-sf-cli.Dockerfile \
  -t sfp-pro-sf-cli:local .

# Remove the token file
rm .npmrc.token

Build Arguments

The following build arguments are supported:

  • NODE_MAJOR: Node.js major version (default: 22)

  • SFP_VERSION: Version of SFP Pro to build

  • GIT_COMMIT: Git commit hash for versioning

  • SF_COMMIT_ID: Salesforce commit ID

Support

For issues or questions about Docker images, please contact flxbl support through your designated support channels.

Last updated 5 months ago