How to use a custom image on a self hosted runner as the pipeline Image

Question

Hello,

This is the scenario I have. 
I'm using a linux machine as a self hosted agent. On this agent I have a custom Image that has all my requirements.
Is there a way to specify in the bitbucket-pipeline.yml file to use this image?

For example in github I would do:

runs-on: self-hosted-linux # self hosted agent tag
container: my-custom-image:latest

Container here specifies the image that already exists on self-hosted-linux and tells the pipeline to create a container from that image and use it as an image for the pipeline.

Is there an equivalent in Bitbucket?
Thanks!

Ben · Answer

Hi Anthony,

Can you try reference the image like this if it is hosted locally?

name: localhost:0000/imagename

Where 0000 is the port number and imagename is the name of the image.

Cheers!

- Ben (Bitbucket Cloud Support)

Anthony Bou Eid · Answer

I tried the approach foudn in the 2nd link:

definitions:  services:    docker-custom:      type: docker      image: private-image (this is the image that is on the self-hosted linux machine)
pipelines:  default:      - step:          name: test          runs-on:             - 'self.hosted'            - 'linux'          services:            - docker-custom          script:            - python3 main.py

This throws an error saying that I have to authenticate with my Azure Container Registry to use the image... It doesn't use the image that is found on the machine

Ben · Answer

Hey Anthony,

Custom docker images used in your build environment are only compatible with Linux Docker runners, it is not supported within Linux Shell environments.

Here is some documentation to assist you further:

* https://support.atlassian.com/bitbucket-cloud/docs/set-up-and-use-runners-for-linux/
*  https://support.atlassian.com/bitbucket-cloud/docs/configure-your-runner-in-bitbucket-pipelines-yml/#Custom-docker-in-docker-image

Cheers!

- Ben (Bitbucket Cloud Support)