Azure App Service on Linux FAQ

You can find all Docker files on GitHub.

These commands or scripts are executed after the built-in Docker container is started, but before your application code is started.

This action is the same as a Docker restart.

Yes, you can do that through the source control management (SCM) site.

Set the reserved field of the app service to true.

Yes.

Yes, you need to set an app setting called WEBSITE_WEBDEPLOY_USE_SCM to false.

If Git deployment fails to your Linux web app, choose one of the following options to deploy your application code:

• Use the Continuous Delivery (Preview) feature: You can store your app's source code in an Azure DevOps Git repo or GitHub repo to use Azure Continuous Delivery. For more information, see How to configure Continuous Delivery for Linux web app.

• Use the ZIP deploy API: To use this API, SSH into your web app and go to the folder where you want to deploy your code. Run the following code:

  curl -X POST -u <user> --data-binary @<zipfile> https://{your-sitename}.scm.chinacloudsites.cn/api/zipdeploy
  

  If you get an error that the curl command is not found, make sure you install curl by using apt-get install curl before you run the previous curl command.

Yes, disable perMessageDeflate in your server-side Node.js code. For example, if you are using socket.io, use the following code:

const io = require('socket.io')(server,{
  perMessageDeflate :false
});

Yes.

Yes, during a Git deployment, Kudu should detect that you're deploying a PHP application (thanks to the presence of a composer.lock file), and Kudu will then trigger a composer install.

Yes, this functionality is available from the Azure CLI. You can use system-assigned or user-assigned identities. This functionality isn't currently supported in the Azure portal.

If WEBSITES_ENABLE_APP_SERVICE_STORAGE setting is unspecified or set to false, the /home/ directory will not be shared across scale instances, and files written will not persist across restarts. Explicitly setting WEBSITES_ENABLE_APP_SERVICE_STORAGE to true will enable the mount. Once this is set to true, if you wish to disable the mount, you need to explicitly set WEBSITES_ENABLE_APP_SERVICE_STORAGE to false.

You can configure the amount of time the platform will wait before it restarts your container. To do so, set the WEBSITES_CONTAINER_START_TIME_LIMIT app setting to the value you want. The default value is 230 seconds, and the maximum value is 1800 seconds.

Provide the full registry URL, including http:// or https://. For Azure Container Registry with private endpoints and pulling images over virtual network, explicitly remove the http:// or https:// when using Admin credentials (for example, myacr.azurecr.cn).

Add the full image name, including the private registry URL (for example, myacr.azurecr.cn/dotnet:latest). Image names that use a custom port cannot be entered through the portal. To set docker-custom-image-name, use the az command-line tool.

We don't support exposing more than one port.

The SCM site runs in a separate container. You can't check the file system or running processes of the app container.

No, the platform handles HTTPS termination at the shared front ends.

Yes, this is required for custom containers. To manually configure a custom port, use the EXPOSE instruction in the Dockerfile and the app setting, WEBSITES_PORT, with a port value to bind on the container.

Yes, overwrite the environmental variable before .NET core app starts. E.g. In the init.sh script: export ASPNETCORE_URLS={Your value}

In order to use ACR with multi-container, all container images need to be hosted on the same ACR registry server. Once they are on the same registry server, you will need to create application settings and then update the Docker Compose configuration file to include the ACR image name.

Create the following application settings:

• DOCKER_REGISTRY_SERVER_USERNAME
• DOCKER_REGISTRY_SERVER_URL (full URL, ex: https://<server-name>.azurecr.cn). With private endpoints and virtual networks, remove the http:// or https:// when using Admin credentials.
• DOCKER_REGISTRY_SERVER_PASSWORD (enable admin access in ACR settings)

Within the configuration file, reference your ACR image like the following example:

image: <server-name>.azurecr.cn/<image-name>:<tag>

• Only one container can be open for access
• Only port 80 and 8080 is accessible (exposed ports)

Here are the rules for determining which container is accessible - in the order of precedence:

• Application setting WEBSITES_WEB_CONTAINER_NAME set to the container name
• The first container to define port 80 or 8080
• If neither of the above is true, the first container defined in the file will be accessible (exposed)

The depends_on option is unsupported on App Service and it'll be ignored. Just as the control startup and shutdown recommendation from Docker, App Service Multi-container apps should check dependencies through application code - both at startup and disconnection.

The example code below shows a Python app checking to see if a Redis container is running.

import time

import redis
from flask import Flask

app = Flask(__name__)
cache = redis.Redis(host='redis', port=6379)

def get_hit_count():
    retries = 5
    while True:
        try:
            return cache.incr('hits')
        except redis.exceptions.ConnectionError as exc:
            if retries == 0:
                raise exc
            retries -= 1
            time.sleep(0.5)

@app.route('/')
def hello():
    count = get_hit_count()
    return 'Hello from Azure App Service team! I have been seen {} times.\n'.format(count)

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=80, debug=True)

Web Sockets

Web Sockets are supported on Linux apps.

Pricing varies by SKU and region but you can see more details at our pricing page: App Service Pricing.

The file system of your application is a mounted network share. This enables scale out scenarios where your code needs to be executed across multiple hosts. Unfortunately this blocks the use of file-based database providers like SQLite since it's not possible to acquire exclusive locks on the database file. We recommend a managed database service: Azure SQL, Azure Database for MySQL or Azure Database for PostgreSQL

You can use only letters (A-Z, a-z), numbers (0-9), and the underscore character (_) for application settings.

You can submit your idea at the Web Apps feedback forum. Add "[Linux]" to the title of your idea.

Next steps

• What is Azure App Service on Linux?
• Set up staging environments in Azure App Service
• Things You Should Know: Web Apps and Linux
• Environment variables and app settings reference