Usage

• Managing Sessions with Peak-SDK
  • Sessions
    • Importing and defining a custom Session objects for use within clients
      • This custom Session object can be passed when creating new clients of any kind.
      • The main purpose of this is to allow for the use of custom Session objects when working across multiple tenants simultaneously.
      • Multi-Environment usage example with a Workflow client
      • The default behavior is to pick up arguments from the user’s environment.
• Interacting with Peak resource services
  • Image resource
    • Import the image resource module and instantiate the client
    • List all existing image(s) and iterate over them
    • List all existing image version(s) and iterate over them
    • Create a new image resource
    • Create a new image version resource
    • Create or update a image version
    • Describe an existing image resource
    • Describe an existing version resource
    • Update an existing image version resource
    • List all builds in an existing image resource and iterate over them
    • Get logs for a specific build in an existing image resource
    • Delete an existing image version resource
    • Delete multiple existing image version resources
    • Delete an existing image resource
  • Workflows resource
    • Import the workflow resource module and instantiate a workflow-service client
    • List all existing workflow(s) and iterate over them
    • Prepare the payload and submit a new workflow resource for creation
    • Modify the payload and update the existing workflow resource
    • Modify the payload and update the existing workflow resource via patch-workflow
    • Create or update a workflow resource
    • Describe an existing workflow resource
    • Delete an existing workflow resource
    • List all executions of a workflow resource and iterate over them
    • Get Details about a workflow execution
    • Get logs for a specific execution of a workflow resource
    • Schedule an immediate execution for a workflow
    • Get all available resources for workflow
    • Get default resource values for workflow
  • Artifacts resource
    • Import the artifact resource module and instantiate an artifact-service client
    • Create a new artifact resource by uploading a file
    • List all existing artifact(s) and iterate over them
    • Describe an existing artifact
    • Update an artifact resource with a new version by uploading a new file
    • Update an artifact resource’s existing metadata
    • Download a versioned artifact from an existing artifact resource
    • Delete an artifact version from an existing artifact resource
    • Delete an artifact resource along with all its version(s)
  • Tenants resource
    • Import the tenant resource module and instantiate the tenant-service client
    • List all available instance-options(s)
  • Webapps resource
    • Import the webapps resource module and instantiate a webapps-service client
    • List all existing webapps(s) and iterate over them
    • Prepare the payload and submit a new Webapp resource for creation
    • Modify the payload and update the existing Webapp resource
    • Create or update a Webapp resource
    • Delete an existing Webapp resource
    • Describe an existing Webapp resource
• Interacting with Press framework services
  • Press Apps
    • Import the press app module and Instantiate a press-app client
    • Prepare an app-spec payload and create an app-spec
    • List created app-spec(s) and iterate over them
    • Describe an already existing app-spec
    • Update an app-spec’s metadata
    • Create a new app-spec release with updated config and release
    • Describe the app-spec release
    • List all app-spec release(s) and iterate over them
    • Create a new deployment from an existing app-spec release
    • List all existing deployment(s) and iterate over them
    • Describe an existing deployment
    • Update an existing deployment’s metadata
    • Create app deployment revision from a specific app-spec’s release
    • Describe an app deployment revision
    • List all revision(s) in an app deployment and iterate over them
    • Delete an existing deployment
    • Delete an existing app-spec with all its release(s)
  • Press Blocks
    • Import the press block module and Instantiate a press-block client
    • Prepare payload and create a new workflow block-spec
    • Prepare payload and create a new webapp block-spec
    • List created block-spec(s) and iterate over them
    • Describe an already existing block-spec
    • Update the metadata and discoverability of a block-spec
    • Create a new workflow block-spec release with updated config and release
    • Create a new webapp block-spec release with updated config and release
    • Describe the block-spec release
    • List all release(s) in a block-spec and iterate over them
    • Create a new deployment from a specific block-spec’s release
    • List all existing deployment(s) and iterate over them
    • Describe a block deployment
    • Update an existing deployment’s metadata
    • Get block deployment parameters
    • Update block deployment parameters
    • Create block deployment revision from a specific block-spec’s release
    • Describe a block deployment revision
    • List all revision(s) in a block deployment and iterate over them
    • Delete a block deployment
    • Delete an existing block-spec with all it’s release(s)
  • Press Deployments
    • Import the press deployment module and Instantiate a press-deployment client
    • List all app deployment(s) and block deployment(s) and iterate over them
  • Press Specs
    • Import the press spec module and Instantiate a press-spec client
    • List all app spec(s) and block spec(s) and iterate over them
    • List all deployment(s) for an existing app-spec release
• Managing Auto-Pagination when available with Peak-SDK
  • Client Side Auto-Pagination
    • Import the press app module and Instantiate a press-app client
    • List created app-spec(s) and iterate over them using auto-pagination with return_iterator=True
    • List created app-spec(s) with auto-pagination disabled
• Using Templates in Peak-SDK and Peak-CLI
  • Getting familiar with Templates
    • Using template loader along with your own code.
    • Using template loader with CLI commands.
      • Visualizing the template loading logic used within CLI commands
    • Usage Examples
      • Passing parameters in bulk.
      • Passing parameters one by one.
      • The recommended way.
      • A short guide to parameter conventions used within the CLI.
• Using Compression for Artifacts in Peak-SDK and Peak-CLI
  • Why do we need Artifacts and Compression
    • Usage Examples
      • Basic usage with path and ignore_files
      • Usage without ignore_files
      • Compress without ignore_files and a missing .dockerignore
      • Compress without both ignore_files and .dockerignore
      • Usage with multiple ignore files
      • The recommended way
• Creating Apps and Blocks via SDK
  • Creating Resource Dependencies with Artifacts
  • Providing Instance Type and Storage in Workflow Block Spec
  • Providing Instance Type in Webapp Block Spec
  • Session Stickiness in Webapp Block
  • Providing Build Parameters in Blocks
  • Providing Run Parameters in Blocks
  • Providing Triggers in Workflow Block Spec
  • Providing Watchers in Workflow Block Spec
  • Providing Image Details for Block Specs
  • Usage Examples
    • Block Specs
      • Creating a Block Spec
      • Creating a new Block Spec Release
    • Block Deployments
      • Creating a new Block Deployment
    • Block Deployments Revisions
      • Creating a new Block Deployment Revision
    • App Specs
      • Creating an App Spec
      • Creating a new App Spec Release
    • App Deployments
      • Creating a new App Deployment
    • App Deployments Revision
      • Creating a new App Deployment Revision
    • Fetching related Blocks within an App
• Creating Images, Workflows and Webapps via SDK
  • Creating Resource Dependencies with Artifacts
  • Providing Instance Type and Storage in Workflow
  • Providing Instance Type in Webapp
  • Session Stickiness in Webapp
  • Images
    • Creating an image
    • Creating an image version
  • Workflows
    • Creating a workflow
    • Executing a workflow
  • Webapps
    • Creating a webapp
• Using Tools from Peak-SDK
  • Logging 📓
    • Importing and creating a logging instance 🧪
      • Example 1: Get a default logger
      • Example 2: Get a customised logger
    • Masking sensetive data 🧪
      • Example 1: Masking is enabled by default
      • Example 2: Disabling masking
    • Binding and unbinding contexts 🧪
      • Example 1: Bind additional context to logger
      • Example 2: Unbind key(s) from the context
    • Changing log level 🧪
      • Example 1: Change or Set the log level
    • Additional examples 🧪
      • Example 1: Using Formatting Placeholders
      • Example 2: Logging with Structured Data
      • Example 3: Logging Mixed Data Types
      • Example 4: Logging Exceptions