Post Installation Tasks for Deployments

This section provides post-installation instructions for deploying the Apcera Platform.

The following documentation assumes you have successfully deployed an Apcera cluster on a supported platform.

Configure DNS

To access the cluster after deployment, you must create or update two public DNS "A" records that map the base_domain to the IP address of the cluster HTTP Router (NGNIX) or to the load balancer if you are running multiple HTTP routers:

  • Fully-qualified domain name (FDQN): {DOMAIN} and
  • Wildcard entry: *.{DOMAIN}

You may also need to create a DNS record for the TCP router if you are using one. See Configuring DNS for guidance.

For some installation platforms, such as Azure, you must configure DNS before deployment. Refer to the installation instructions for your chosen platform.

Connect to the cluster

Once you have successfully deployed the cluster, connect to it as follows.

Log on to the web console

Make sure that the browser is using the proper DNS.

Log on to the web console at http(s)://console.<cluster-name>.<domain-name>.<tld>.

For example: https://console.zoaz.apcera-ee.net.

Target your cluster and login using APC

Download and install the APC client.

Target your cluster and log in:

$ ./apc target http://apcera.test
Note: connections over HTTP are insecure and may leak secure information.

Targeted [http://apcera.test]
$ ./apc login --basic

Connecting to http://apcera.test...

Username: admin
Password: ********

Install Apcera packages

An Apcera container instance requires both the OS and execution parts in the binary. Apcera builds the container based on the packages in the system that meet the dependencies.

Every Apcera package binary has both depends and provides within its metadata. If the depends are not met by a matching provides somewhere within the Apcera list of available packages then the deployment of the job fails: Error - No packages satisfy dependency "os.linux".

The bare minimum package requirements for an Apcera cluster are the following Ubuntu OS packages:

  • ubuntu-14.04-apc3.cntmp
  • ubuntu-14.04-build-essential-apc4.cntmp

Installing these two Ubuntu OS packages will only let you deploy Docker images and capsules, not applications from source code. To deploy apps from source code you will need to install additional packages to provide any dependencies the app requires.

Apcera requires the os.linux package to run Docker images and capsules because the system creates a short-lived helper job to download and convert the image. This helper job runs on an IM and depends on a base Linux package. Apcera supports running Docker images, but does so using its own container format.

The "ubuntu-14.04-apc3.cntmp" package provides the following to satisfy the OS dependency:

  • "os.linux"
  • "os.ubuntu"
  • "os.linux-14.04"
  • "os.linux-14.04-apc3"

Install base packages

Contact Apcera Support to download the base packages that you need.

To install the bare minimum Ubuntu OS packages:

  1. Target your cluster and log in using APC.

  2. Import the packages to your cluster using APC.

     apc package import *.cntmp --batch
    
  3. Verify package import.

     apc package list -ns /
    

Install additional packages

To deploy applications from source code you build and import the packages that satisfy the application's dependencies.

  1. Download the desired package script file(s) from the https://github.com/apcera/package-scripts repository.

  2. Build the package binary from the script using APC.

    For example:

     apc package build nginx-1.11.1.conf
    
  3. Import the package.

    For example:

     apc package import nginx-1.11.1.cntmp --batch
    
  4. Verify package import.

     apc package list -ns /
    

Run Hello World

To verify that your cluster is successfully installed, deploy a simple web app.

  1. Check that you have the following packages installed in your cluster:

    • "ubuntu-14.04-apc3.cntmp"
    • "nginx-1.11.1.cntmp"
  2. Clone or download the Apcera sample apps from the GitHub repository.

     git clone https://github.com/apcera/sample-apps.git
    
  3. Deploy a static web site using APC.

     cd ~/sample-apps/example-static
     apc app create my-example-static-website --start --batch
    
  4. Open the web site in a browser.

    Naviage to the URL provided from the app staging process.

     App should be accessible at "http://mywebsite-h3f435.apcera.test"
    

    It should print out "Hello World" as expected.

Developer tutorials

Check out these additional Apcera developer resources: