microsoft/service-fabric-onebox repository overview

⁠Featured Tags

• u18
  docker pull mcr.microsoft.com/service-fabric/onebox:u18
• u16
  docker pull mcr.microsoft.com/service-fabric/onebox:u16
• latest
  docker pull mcr.microsoft.com/service-fabric/onebox:latest

⁠About this image

This image is used to build a Docker image that can run the Service Fabric for Ubuntu cluster inside a container. This allows users on Windows, Linux or Mac based developer environments to have a local cluster on their machines.

⁠How to Use this Image

For information on how to use this image on Mac or Linux environments please follow instructions here⁠.

1. Update the Docker daemon configuration on your host with the following settings and restart the Docker daemon. Details: Enable IPv6 support⁠

   {
       "ipv6": true,
       "fixed-cidr-v6": "fd00::/64"
   }
   

   Copy

2. Start the cluster:

   docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u18
   

   Copy

3. Connect to the cluster using SF CLI, SDK, or other management tools and deploy Service Fabric microservice applications.
   Manage an Azure Service Fabric application by using Azure Service Fabric CLI (sfctl)⁠
   Deploy and remove applications using PowerShell⁠

⁠Configuration

• At least 4 GB of RAM.
• The latest version of Docker.

⁠Full Tag Listing

⁠Legend

* - Uses previous generation UX pattern. To create cluster on these images, create Dockerfile with contents below. Replace 'latest' base image with desired tag.

FROM mcr.microsoft.com/service-fabric/onebox:latest
WORKDIR /home/ClusterDeployer
RUN ./setup.sh
#Generate the local
RUN locale-gen en_US.UTF-8
#Set environment variables
ENV LANG=en_US.UTF-8
ENV LANGUAGE=en_US:en
ENV LC_ALL=en_US.UTF-8
EXPOSE 19080 19000 80 443
#Start SSH before running the cluster
CMD /etc/init.d/ssh start && ./run.sh

Build from Dockerfile directory:

docker build -t mysfcluster .

Run cluster:

docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mysfcluster

⁠Support

If you have any problems with or questions about this image, please contact us through a GitHub issue⁠.

⁠Troubleshooting

To get diagnostic details run:

docker logs sftestcluster

• If the cluster container doesn't start and exits with error:

  Starting Fabric Host as console application.
  IPC server open failed with 0x80070063
  

  Copy

  Enable IPv6 in docker daemon using steps above: "How to Use this Image"

  Details: https://docs.docker.com/config/daemon/ipv6/⁠

⁠License

• Legal Notice: Container License Information⁠

⁠Additional References

• Prepare your development environment on Linux⁠
  
• Set up your development environment on Mac OS X⁠
  
• Set up a Linux Service Fabric cluster on your Windows developer machine⁠
• Learn about Service Fabric support options⁠