Git Product home page Git Product logo

apb's Introduction

apb

Getting Started

Create a namespace

Once logged into your OCP cluster, you must first create a project:

$ oc new-project test-project

Add a registry

First add the default registry (ansibleplaybookbundle on Dockerhub):

$ apb registry add docker

Or to add a custom registry:

$ apb registry add docker --org ansibleplaybookbundle --type dockerhub

Then you can list your registries:

$ apb registry list
Found registries already in config:                                   
 NAME       TYPE          ORG                       URL               
 ------ -+- --------- -+- --------------------- -+- ---------         
 docker  |  dockerhub  |  ansibleplaybookbundle  |  docker.io

List available APBs

Once a registry is configured, run apb bundle list:

$ apb bundle list
Found specs already in registry: [docker]                                                                                                    
 BUNDLE                    IMAGE                                                                   REGISTRY                                  
 --------------------- -+- ------------------------------------------------------------------- -+- --------                                  
 blankvm-apb            |  docker.io/ansibleplaybookbundle/virtualmachines-apb:latest           |  docker                                    
 prometheus-apb         |  docker.io/ansibleplaybookbundle/prometheus-apb:latest                |  docker                                    
 dynamic-apb            |  docker.io/ansibleplaybookbundle/dynamic-apb:latest                   |  docker                                    
 eclipse-che-apb        |  docker.io/ansibleplaybookbundle/eclipse-che-apb:latest               |  docker                                    
 etherpad-apb           |  docker.io/ansibleplaybookbundle/etherpad-apb:latest                  |  docker                                    
 pyzip-demo-db-apb      |  docker.io/ansibleplaybookbundle/pyzip-demo-db-apb:latest             |  docker

This command loads and caches APB specs (metadata) from newly added registries. Cached specs can be updated with apb bundle list --refresh

Provision an APB

Provision any of the listed APBs like so:

$ apb bundle provision <bundle_name> -n myproject --follow

To provision an APB with the admin ClusterRole used in the APB sandbox, run:

$ apb bundle provision <bundle_name> -n myproject --sandbox-role admin --follow

Note: the --follow flag waits for the APB to start running and shows logs on-screen.

Tips

Enabling tab completion for apb

apb supports command tab completion for bash and zsh:

$ source <(apb completion bash) # load bash completion into session
$ source <(apb completion zsh) # load zsh completion into session

Troubleshooting

Using apb with openshift.io

In the starter tier of openshift.io, the secret quota is 20 (at the time of this writing). Since each apb bundle provision action creates a serviceaccount with an API token residing in a secret, it's possible to hit this limit after a few provisions. Cleaning up bundle-*****-[..] serviceaccounts will help resolve this. You can check if you're hitting this limit with oc get quota object-counts -o yaml

apb's People

Contributors

dymurray avatar djwhatle avatar jmrodri avatar jmontleon avatar djzager avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.