Added new samples.

Author: Paul Cornell

doc_source/_find-environment.txt

@@ -8,9 +8,9 @@
    either express or implied. See the License for the specific language governing permissions and
    limitations under the License.
 
-If your |env| is not displayed in the console, try doing one or more of the following actions to try to display it:
+If your |env| is not displayed in the console, try doing one or more of the following actions to try to display it.
 
-* In the side navigation bar, choose one or more of the following:
+* In the side navigation bar, choose one or more of the following.
 
   * Choose :guilabel:`Your environments` to display all environments that your AWS entity owns within the selected AWS Region and AWS account.
   * Choose :guilabel:`Shared with you` to display all environments your AWS entity has been invited to within the selected AWS Region and AWS account.

doc_source/_includes.txt

@@ -82,4 +82,23 @@
 .. |memslongtitle| replace:: |envtitle| Members
 .. |memslong| replace:: |env| members
 .. |memstitle| replace:: Members
-.. |mems| replace:: members
+.. |mems| replace:: members
+
+.. AWS Region IDs
+   --------------
+.. |region-id-ap-northeast-1| replace:: ap-northeast-1
+.. |region-id-ap-northeast-2| replace:: ap-northeast-2
+.. |region-id-ap-northeast-3| replace:: ap-northeast-3
+.. |region-id-ap-south-1| replace:: ap-south-1
+.. |region-id-ap-southeast-1| replace:: ap-southeast-1
+.. |region-id-ap-southeast-2| replace:: ap-southeast-2
+.. |region-id-ca-central-1| replace:: ca-central-1
+.. |region-id-eu-central-1| replace:: eu-central-1
+.. |region-id-eu-west-1| replace:: eu-west-1
+.. |region-id-eu-west-2| replace:: eu-west-2
+.. |region-id-eu-west-3| replace:: eu-west-3
+.. |region-id-sa-east-1| replace:: sa-east-1
+.. |region-id-us-east-1| replace:: us-east-1
+.. |region-id-us-east-2| replace:: us-east-2
+.. |region-id-us-west-1| replace:: us-west-1
+.. |region-id-us-west-2| replace:: us-west-2

doc_source/ami-contents.rst

@@ -20,26 +20,27 @@ Amazon Machine Image (AMI) Contents for an |envfirstlongec2title|
 
 The Amazon Machine Image (AMI) that |AC9long| uses for an |envec2| contains the following components:
 
-* The packages listed in `Amazon Linux AMI 2017.09 Packages <https://aws.amazon.com/amazon-linux-ami/2017.09-packages/>`_ on the Amazon Linux AMI website.
+* The packages listed in `Amazon Linux AMI 2018.03 Packages <https://aws.amazon.com/amazon-linux-ami/2018-03-packages/>`_ on the Amazon Linux AMI website.
 * `Apache HTTP Server <http://httpd.apache.org/>`_ 2.4
-* :ref:`AWS CLI <sample-aws-cli>`
-* `AWS SAM Local <https://github.com/awslabs/aws-sam-local>`_
-* `CoffeeScript <http://coffeescript.org>`_ 
-* `Docker <https://www.docker.com/>`_ 17.03.2-ce
+* :ref:`AWS CLI <sample-aws-cli>` 1.14.9
+* `AWS SAM Local <https://github.com/awslabs/aws-sam-local>`_ 0.2.11
+* `CoffeeScript <http://coffeescript.org>`_ 2.3.1
+* `Docker <https://www.docker.com/>`_ 18.03.1-ce
 * `GCC, G++ <https://gcc.gnu.org/>`_ 4.8.5
 * `GDB <https://www.gnu.org/software/gdb/>`_ 7.6.1
-* `Git <https://git-scm.com/>`_ 2.13.6
+* `Git <https://git-scm.com/>`_ 2.14.4
 * `GNU libc <https://www.gnu.org/software/libc/>`_ 2.17
 * `Go <https://golang.org>`_ 1.9.1
 * `MySQL <https://dev.mysql.com/>`_ 14.14
 * `MySQL native driver for PHP <https://dev.mysql.com/downloads/connector/php-mysqlnd/>`_ 
-* `Node.js <https://nodejs.org/en/>`_ v6.11.4
+* `Node.js <https://nodejs.org/en/>`_ v6.14.3
 * `Node Package manager (npm) <https://www.npmjs.com/>`_ 3.10.10
 * `Node Version Manager (nvm) <http://nvm.sh/>`_ 0.31.7
-* `PHP <https://secure.php.net/>`_ 5.6.31
-* `Pylint <https://www.pylint.org/>`_ 1.7.4
-* `Python <https://www.python.org/>`_ 2.7.12
-* `Python <https://www.python.org/>`_ 3.6.2
-* `Ruby on Rails <http://rubyonrails.org/>`_ 5.1.4
+* `Perl <https://www.perl.org/>`_ v.5.16.3
+* `PHP <https://secure.php.net/>`_ 5.6.36
+* `Pylint <https://www.pylint.org/>`_ 1.8.1
+* `Python <https://www.python.org/>`_ 2.7.14
+* `Python <https://www.python.org/>`_ 3.6.5
+* `Ruby on Rails <http://rubyonrails.org/>`_ 5.2.0
 * `Ruby <https://www.ruby-lang.org/en/>`_ 2.4.1
-* `virtualenv <https://virtualenv.pypa.io/en/stable/>`_ 15.1.0
+* `virtualenv <https://virtualenv.pypa.io/en/stable/>`_ 16.0.0

doc_source/app-preview.rst

@@ -118,6 +118,8 @@ and with the corresponding application code file open and active in the |AC9IDE|
 
 This opens an application preview tab within the |env|, and then displays the application's output on the tab.
 
+If the application preview tab displays an error or is blank, try following the troubleshooting steps in :ref:`troubleshooting-app-preview`.
+
 To enable others to preview the running application outside of the |IDE|, see :ref:`app-preview-share`. 
 
 .. note:: If the application is not already running, you will see an error on the application preview tab. Run or restart the application, and then choose the menu bar command again.
@@ -127,7 +129,13 @@ To enable others to preview the running application outside of the |IDE|, see :r
    within the |env| works only with the preceding ports and IPs, and it works with only a single port at a time.
 
    We don't recommend sharing the URL in the application preview tab with others. (The URL displays using the format 
-   :code:`https://ENVIRONMENT_ID.vfs.cloud9.REGION_ID.amazonaws.com/`.) This URL works only when the |IDE| for the |env| is open and the application is running in the same web browser.    
+   :code:`https://12a34567b8cd9012345ef67abcd890e1.vfs.cloud9.us-east-2.amazonaws.com/`, where :code:`12a34567b8cd9012345ef67abcd890e1` is the ID that |AC9| assigns to the |env|, 
+   and :code:`us-east-2` is the ID of the AWS Region for the |env|.) This URL works only when the |IDE| for the |env| is open and the application is running in the same web browser.    
+
+   If you try to go to the IP of :code:`127.0.0.1`, :code:`localhost`, or :code:`0.0.0.0` by using the application preview tab 
+   in the |IDE| or in a separate web browser tab outside of the |IDE|, 
+   the default built-in behavior of the |AC9IDE| is that this will attempt to go to your local computer, instead of attempting to go the 
+   instance or your own server that is connected to the |env|.
 
 .. _app-preview-app-reload:
 
@@ -199,14 +207,14 @@ allow incoming application requests. Then you give the public IP address to othe
 
         curl http://169.254.169.254/latest/meta-data/instance-id
 
-     The instance ID will look similar to this: :code:`i-02ccbdf54d66e34EX`. Make a note of this instance ID.
+     The instance ID will look similar to this: :code:`i-12a3b456c789d0123`. Make a note of this instance ID.
 
    * In the |IDE| for the |env|, on the menu bar, choose your user icon, and then choose :guilabel:`Manage EC2 Instance`.
 
      .. image:: images/console-manage-instance.png
         :alt: Choosing to manage the instance from the AWS Cloud9 IDE
 
-     In the |EC2| console that displays, make a note of the instance ID that displays in the :guilabel:`Instance ID` column. The instance ID will look similar to this: :code:`i-02ccbdf54d66e34EX`. 
+     In the |EC2| console that displays, make a note of the instance ID that displays in the :guilabel:`Instance ID` column. The instance ID will look similar to this: :code:`i-12a3b456c789d0123`. 
 
 #. Get the |EC2| instance's public IP address. To get this, do one of the following:
 
@@ -326,6 +334,8 @@ Step 5: Share the Running Application URL
 With the application running, give to others the public IP address you noted earlier. Be sure to start the URL with the correct protocol, and add the port number if it is 
 not the default for that protocol (for example, :code:`http://192.0.2.0:8080/index.html` using HTTP over port 8080).
 
+If the resulting web browser tab displays an error, or the tab is blank, try following the troubleshooting steps in :ref:`troubleshooting-app-sharing`.
+
 .. note:: The instance's public IP address might change anytime the instance restarts. To prevent this IP address from changing, one solution is to allocate an Elastic IP address and then assign that address to the running instance. For instructions, see 
    :ec2-user-guide:`Allocating an Elastic IP Address <elastic-ip-addresses-eip.html#using-instance-addressing-eips-allocating>` and 
    :ec2-user-guide:`Associating an Elastic IP Address with a Running Instance <elastic-ip-addresses-eip.html#using-instance-addressing-eips-associating>` in the |EC2-ug|. Note also that 
@@ -338,4 +348,5 @@ not the default for that protocol (for example, :code:`http://192.0.2.0:8080/ind
    port, those requests might fail. Those users must use a different network that allows traffic over the requested protocol and port. For more information, see your network administrator.
 
    We don't recommend sharing the URL in the application preview tab in the |IDE| with others. (The URL displays using the format 
-   :code:`https://ENVIRONMENT_ID.vfs.cloud9.REGION_ID.amazonaws.com/`.) This URL works only when the |IDE| for the |env| is open and the application is running in the same web browser.
+   :code:`https://12a34567b8cd9012345ef67abcd890e1.vfs.cloud9.us-east-2.amazonaws.com/`, where :code:`12a34567b8cd9012345ef67abcd890e1` is the ID that |AC9| assigns to the |env|, 
+   and :code:`us-east-2` is the ID of the AWS Region for the |env|.) This URL works only when the |IDE| for the |env| is open and the application is running in the same web browser.

doc_source/auth-and-access-control.rst

@@ -298,7 +298,8 @@ The following AWS managed policies, which you can attach to |IAM| identities in
          {
            "Effect": "Allow",
            "Action": [
-             "cloud9:CreateEnvironment*",
+             "cloud9:CreateEnvironmentEC2",
+             "cloud9:CreateEnvironmentSSH",
              "cloud9:GetUserPublicKey",
              "cloud9:GetUserSettings",
              "cloud9:UpdateUserSettings",

doc_source/browsers.rst

@@ -0,0 +1,36 @@
+.. Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+   This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0
+   International License (the "License"). You may not use this file except in compliance with the
+   License. A copy of the License is located at http://creativecommons.org/licenses/by-nc-sa/4.0/.
+
+   This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+   either express or implied. See the License for the specific language governing permissions and
+   limitations under the License.
+
+.. _browsers:
+
+############################
+Supported Browsers for |AC9|
+############################
+
+.. meta::
+    :description:
+        Lists the supported browsers for AWS Cloud9.
+        
+The following table lists the supported browsers for |AC9|.
+
+.. list-table::
+   :widths: 1 1
+   :header-rows: 1
+
+   * - **Browser**
+     - **Versions**
+   * - Google Chrome
+     - Latest three versions
+   * - Mozilla Firefox
+     - Latest three versions
+   * - Microsoft Edge
+     - Latest three versions
+   * - Apple Safari for macOS
+     - Latest two versions

doc_source/build-run-debug.rst

@@ -162,9 +162,9 @@ Change a Built-In Runner
 
 #. On the menu bar, choose :guilabel:`Run, Run With`, and then choose the built-in runner you want to change.
 #. Stop the runner from trying to run your code by choosing, :guilabel:`Stop` on the run configuration tab that displays.
-#. Choose :guilabel:`Runner: RUNNER_NAME`, where :guilabel:`RUNNER_NAME` is the name of the runner you want to change, and then choose :guilabel:`Edit Runner`.
-#. On the :guilabel:`RUNNER_NAME.run` tab that is displayed, change the runner's current definition. See :ref:`build-run-debug-define-builder-runner`.
-#. Choose :guilabel:`File, Save As`. Save the file with the same name (:guilabel:`RUNNER_NAME.run`) in the :file:`ENVIRONMENT_NAME/.c9/runners` directory, where :file:`ENVIRONMENT_NAME` is
+#. Choose :guilabel:`Runner: My Runner`, where :guilabel:`My Runner` is the name of the runner you want to change, and then choose :guilabel:`Edit Runner`.
+#. On the :guilabel:`My Runner.run` tab that is displayed, change the runner's current definition. See :ref:`build-run-debug-define-builder-runner`.
+#. Choose :guilabel:`File, Save As`. Save the file with the same name (:guilabel:`My Runner.run`) in the :file:`my-environment/.c9/runners` directory, where :file:`my-environment` is
    the name of your |envfirst|.
 
 .. note:: Any changes you make to a built-in runner apply only to the |env| you made those changes in. To apply your changes to a separate |env|,
@@ -202,8 +202,8 @@ Create a Builder or Runner
    that is displayed, define the builder or runner.
    See :ref:`build-run-debug-define-builder-runner`.
 #. After you define the builder or runner, choose :guilabel:`File, Save As`. For a builder, save the file with the :file:`.build` extension in the
-   :file:`ENVIRONMENT_NAME/.c9/builders` directory, where :file:`ENVIRONMENT_NAME` is the name of your |env|. For a runner, save the file with the
-   :file:`.run` file extension in the :file:`ENVIRONMENT_NAME/.c9/runners` directory, where :file:`ENVIRONMENT_NAME`
+   :file:`my-environment/.c9/builders` directory, where :file:`my-environment` is the name of your |env|. For a runner, save the file with the
+   :file:`.run` file extension in the :file:`my-environment/.c9/runnders` directory, where :file:`my-environment`
    is the name of your |env|.
    The file name you specify will be the name that is displayed on the :guilabel:`Run, Build System` menu (for a builder) or the
    :guilabel:`Run, Run With` menu (for a runner). Therefore, unless you specify a different file name,
@@ -247,7 +247,7 @@ For a runner, start with this code.
      "env": {},
      "selector": "",
      "debugger": "",
-     "debugport": "PORT_NUMBER"
+     "debugport": ""
    }
 
 In the preceding code:

doc_source/change-environment.rst

@@ -41,13 +41,13 @@ Change |envtitle| Preferences
 Change |envtitle| Settings with the Console
 ===========================================
 
-#. Open the |AC9| console, if it isn't already open, at |AC9Console_link|.
+#. Sign in to the |AC9| console, at |AC9Console_link|.
 #. In the top navigation bar, choose the AWS Region where the |env| is located.
 
    .. image:: images/console-region.png
       :alt: AWS Region selector in the AWS Cloud9 console
 
-#. In the list of environments, for the |env| whose settings you want to change, do one of the following:
+#. In the list of environments, for the |env| whose settings you want to change, do one of the following.
 
    * Choose the title of the card for the |env|. Then choose :guilabel:`Edit` on the next page.
 
@@ -61,23 +61,23 @@ Change |envtitle| Settings with the Console
 
 #. Make your changes, and then choose :guilabel:`Save changes`.
 
-   You can use the |AC9| console to change the following settings: 
+   You can use the |AC9| console to change the following settings. 
 
    * For |envec2plural|, :guilabel:`Name` and :guilabel:`Description`.
    * For |envsshplural|: :guilabel:`Name`, :guilabel:`Description`, :guilabel:`User`, :guilabel:`Host`, :guilabel:`Port`, 
      :guilabel:`Environment path`, :guilabel:`Node.js binary path`, and :guilabel:`SSH jump host`.
 
-   To change other settings, do the following: 
+   To change other settings, do the following. 
 
-   * For |envec2plural|: 
+   * For |envec2plural|, do the following. 
 
      * You cannot change :guilabel:`Type`, :guilabel:`Security groups`, :guilabel:`VPC`, :guilabel:`Subnet`, :guilabel:`Environment path`, or :guilabel:`Environment ARN`.
      * For :guilabel:`Permissions` or :guilabel:`Number of members`, see :ref:`share-environment-change-access`, 
        :ref:`Remove Your User <share-environment-change-access>`, :ref:`Invite an IAM User <share-environment-invite-user>`, and 
        :ref:`share-environment-delete-member`.
      * For :guilabel:`EC2 instance type`, :guilabel:`Memory`, or :guilabel:`vCPU`, see :ref:`Moving or Resizing an Environment <move-environment>`.
 
-   * For |envsshplural|: 
+   * For |envsshplural|, do the following. 
 
      * You cannot change :guilabel:`Type` or :guilabel:`Environment ARN`.
      * For :guilabel:`Permissions` or :guilabel:`Number of members`, see :ref:`share-environment-change-access`, 

doc_source/conf.py

@@ -125,6 +125,7 @@
 
 extlinks['api-gateway-dev-guide'] = ('https://docs.aws.amazon.com/apigateway/latest/developerguide/%s', '')
 extlinks['aws-gen-ref'] = ('https://docs.aws.amazon.com/general/latest/gr/%s', '')
+extlinks['cfn-cli'] = ('https://docs.aws.amazon.com/cli/latest/reference/cloudformation/%s', '')
 extlinks['cli-user-guide'] = ('https://docs.aws.amazon.com/cli/latest/userguide/%s', '')
 extlinks['codecommit-user-guide'] = ('https://docs.aws.amazon.com/codecommit/latest/userguide/%s', '')
 extlinks['codepipeline-user-guide'] = ('https://docs.aws.amazon.com/codepipeline/latest/userguide/%s', '')
@@ -134,6 +135,7 @@
 extlinks['dynamodb-dev-guide'] = ('https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/%s', '')
 extlinks['ec2-user-guide'] = ('https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/%s', '')
 extlinks['iam-user-guide'] = ('https://docs.aws.amazon.com/IAM/latest/UserGuide/%s', '')
+extlinks['lam-cli'] = ('https://docs.aws.amazon.com/cli/latest/reference/lambda/%s', '')
 extlinks['lambda-dev-guide'] = ('https://docs.aws.amazon.com/lambda/latest/dg/%s', '')
 extlinks['lightsail-docs'] = ('https://lightsail.aws.amazon.com/ls/docs/%s', '')
 extlinks['s3-getting-started-guide'] = ('https://docs.aws.amazon.com/AmazonS3/latest/gsg/%s', '')