Web App for Containers quick start docker images

This repo contains all currently quick start docker images contributed by the community.

Contribution guide

Please follow the guidelines to be compliant . If any docker image is out of compliance , it will be blacklisted from this repo and eventually removed.

Files, folders and naming conventions

Create a new folder for a new docker image and include a version folder . Such as

+my-image
	         \  0.1 
		       \Dockerfile and other files

Note: If you are updating an existing image , create a new version folder within your image folder.

2.Must include a README.md within version folder to describe : a. Any changes with deployment of use of the image b. Include comments if the image is not backward compatible and how user can manually upgrade to new version

Submission Work Flow. The sequence diagram of submission validation work flow.
Best practices. Best practices for improving the quality of your docker image
Git tutorial. Step by step to get you started with Git.
Useful Tools. Useful resources and tools for docker image development

Submission workflow

The submission process as shown below:

Fork the github repostiory
Checkout branch build-test
pull changes from build-test branch
create a new branch or use build-test branch
Commit your changes to the forked repository
Push changes to forked repository
Send a PR ONLY to build-test branch of main repository
Automated Travis CI will run to validate the PR
If build fails , fix the issues and commit changes to the same PR
if build passes the reviewers for the PR will manual verfiy and provide guidance
PR is merged to build-test branch in main repo by repo reviewers
Repo reviewers (Owner) will run sanity test on web app for containers
If the image has no issues it will be merged into master
Image will be deployed to Docker hub

The time taken to approve or reject a PR can vary as this is community driven.

Please submit PR to build-test branch ONLY . Any PR directly submitted to master from a contributor will be rejected.

Owner : The team of members who maintain this repository and review, merge pull requests contributed to the repo.
Submitter : Contributor member of one or more docker images on this repository

Guidance on setting tags during Automated Deployment to Docker hub step:

The related image would be deployed to Docker hub automatically as soon as commit message include string "#sign-off". Below 2 kinds of tags would be set.

Set tag as the value of version folder name. For example:

Update files which under ..\my-image\0.1, 
it would push my-image:0.1 to Docker hub.

Set tag as "latest".

There is 1 file names latest.txt exist under image folder.
The value of above file is as same as the related image version. For example:

Update files which under ..\my-image\0.1, 
..\my-image\latest.txt is exist and the content is "0.1", 
it would also push my-image:latest to Docker hub.

Deploying Samples

You can deploy these samples directly through the Azure Portal

Go to Azure portal
Search for Web app for Containers
Enter web app name , susbcription , resource group
Select configure container and enter the docker hub image name with the tag name. you can find all the docker hub images here
Review the readme.md for the imae you are using to make sure any additional configuration such as app settings need to be updated. Make the necessary changes
Now browse the application