Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

How do you deploy from Pipelines to a remote Docker Swarm cluster ?


I'm trying to get a Bitbucket Pipelines CD setup with a Docker Swarm cluster.

I messaged Geoff on Twitter and he suggested I post here -

You guys have deployment documentation for Kubernetes -

But there is no equivalent documentation for Docker Swarm. Please add documentation for deploys to docker swarm.

4 answers

Here are more details how to use Portainer webhooks for updating Docker swarm service from Bitbucket pipeline:

1.  get docker service webhook url:
 url will be in format

2. store TOKEN to a PORTAINER_WEBHOOK_TOKEN secret variable:

- step:
name: Publish app to Docker Hub
trigger: automatic
- docker login -u $DOCKER_HUB_USER -p $DOCKER_HUB_PWD
- docker build -t XXX:$BUILD_VERSION_APP .
- docker push XXX:$BUILD_VERSION_APP
- step:
name: Deploy to staging
deployment: staging
trigger: manual
- wget --server-response --method POST "$PORTAINER_WEBHOOK_TOKEN?tag=$BUILD_VERSION_APP"


Hi! We are using webhooks as well. As last step in our bitbucket pipeline I trigger a webhook provided from  swarm management tool portainer which is deployed in our swarm cluster with a simple ‚curl -C WEBHOOKURL‘. Portainer fetch the images from a configured registry and make a rolling restart of the images within swarm. Works very smooth. Cheers, phillip

@wiesson that is superb! Thanks for taking the effort. Your recipe is something on the lines that we want to follow. 

However SSH is not an option - we want this to run on every commit/merge. 

Looking forward to see this working on Swarm!

Hi @Sandeep Srinivasa,

Why is SSH not an option? Is it acceptable if SSH is run on every commit/merge as part of the pipeline script?

We have some documentation on setting up SSH commands inside of you pipeline here:

Does that help at all?



Thanks for replying.

For the same reason why kubectl tries not to use it..and every platform provides a SSL/TLS API.

Being able to physically log in to a server is a different security envelope with different considerations. For example, once you are on the server - you can attempt Spectre/Meltdown. You cannot do that with remotely issued docker commands over TLS.

In general, we would strongly request for a transport level security over being able to SSH.

IMHO both k8s and swarm have it - it's just a question of how to set it up with your infrastructure.

Did this ever get anywhere, @Sandeep Srinivasa - did you manage to find a solution?


If you do - please do post here.

Any updates on this? Would be really nice to have a proper way of doing Docker deployments to remote hosts. 

Like Olivier Deprez likes this
Like Jens Riisom Schultz likes this

I was hoping I could execute the `docker stack deploy` remotely from Pipelines but I guess it's not going to happen due to how the remote host connection is set up with Docker. 

Ended up setting up a pipeline where docker-compose.yml is copied to remote host and running commands on the remote host as well. 

0 votes

Hi Sandeep,

I'm not fully sure what Geoff had in mind as a workaround here. He's on leave until next week so I can't ask him until then. As far as I know this isn't possible as Swarm commands aren't available at the moment. But, I'll check with Geoff when he's back.



> Swarm commands aren't available at the moment.

well I guess that was the point for this ! Swarm is the second biggest deployment infra after kubernetes and morever is bundled inside Docker itself.

We would appreciate Bitbucket Pipelines team to tell us how to do this effectively. Swarm already comes with TLS security - 

but unfair to only support kubernetes  :(

Like # people like this

Hi Sandeep,

You can follow this guide to deploy to your Swarm cluster:

You will also need to update the DOCKER_CERT_PATH to point at the API keys of your Swarm cluster, mentioned here:

I don't have an ETA on when we may have a similar guide on Swarm in our own documentation. However, those links should suffice for you by translating the appropriate commands into commands in your deploy step script.



couldnt figure out how to do it with pipelines. maybe im making a stupid mistake.

I pray that you guys do get around to it /hopeful

stage: deploy
DOCKER_HOST: tcp://XXXX:2376
SERVICE_NAME: barfbarf
image: docker:latest
- mkdir -p ~/.docker
- echo "$TLSCACERT" > ~/.docker/ca.pem
- echo "$TLSCERT" > ~/.docker/cert.pem
- echo "$TLSKEY" > ~/.docker/key.pem
- docker login -u gitlab-ci-token -p "$CI_BUILD_TOKEN" "$CI_REGISTRY"
- docker service update --detach=false --with-registry-auth --image$CI_PROJECT_NAME:$CI_BUILD_REF barfbarf
name: production
- master

Basically it works like this code snipped that I posted above (gitlab pipeline). I'm currently trying to "translate" it to bitbucket.

What you can do - SSH to one of your managers and run those commands


docker service update ...
Like Branislav Ballay likes this

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Bitbucket

New improvements to user management in Bitbucket Cloud 👥

Hey Community! We’re willing to wager that quite a few of you not only use Bitbucket, but administer it too. Our team is excited to share that we’ll be releasing improvements throughout this month of...

3,749 views 10 16
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you