/oci-devops

Primary LanguageHCLUniversal Permissive License v1.0UPL-1.0

oci-arch-devops-cicd-with-functions

In this reference architecture, you will build and deploy Python applications using OCI DevOps and OCI function services. The application source code is hosted on a DevOps code repository. The end-user commits the code into the code repository. A new commit to the code repository will trigger the start of a build pipeline. The build pipeline follows a user-defined flow to build the function artifacts to deploy to OCI Function services. The build's output is stored in the container registry as docker images. Then a deployment pipeline uses the built image from the container registry and deploys it to the OCI Function environment. The illustration covers the build and deployment of application build and deployment using a default image and a custom image (Using a docker file).

For details of the architecture, see Build a continuous integration and deployment pipeline using Oracle DevOps service

Terraform Provider for Oracle Cloud Infrastructure

The OCI Terraform Provider is now available for automatic download through the Terraform Provider Registry. For more information on how to get started view the documentation and setup guide.

Deploy Using Oracle Resource Manager

  1. Click Deploy to Oracle Cloud

    If you aren't already signed in, when prompted, enter the tenancy and user credentials.

  2. Review and accept the terms and conditions.

  3. Select the region where you want to deploy the stack.

  4. Follow the on-screen prompts and instructions to create the stack.

  5. After creating the stack, click Terraform Actions, and select Plan.

  6. Wait for the job to be completed, and review the plan.

    To make any changes, return to the Stack Details page, click Edit Stack, and make the required changes. Then, run the Plan action again.

  7. If no further changes are necessary, return to the Stack Details page, click Terraform Actions, and select Apply.

Validate the execution

As this a function the validation to be done via logs . Use OCI Logs for function execution and watch for logs like below .

"Invoked function with default  image" and 
"Invoked function with custom image" 

Deploy Using the Terraform CLI

Clone the Module

Now, you'll want a local copy of this repo. You can make that with the commands:

git clone https://github.com/oracle-quickstart/oci-arch-devops-cicd-with-functions
cd oci-arch-devops-cicd-with-functions
ls

Prerequisites

First off, you'll need to do some pre-deploy setup. That's all detailed here.

Secondly, create a terraform.tfvars file and populate with the following information:

# Authentication
tenancy_ocid         = "<tenancy_ocid>"
user_ocid            = "<user_ocid>"
fingerprint          = "<finger_print>"
private_key_path     = "<pem_private_key_path>"

# Region
region = "<oci_region>"

# Compartment
compartment_ocid = "<compartment_ocid>"

# OCI User and Authtoken
oci_user_name       = "<oci_username> 
# For a federated user (single sign-on with an identity provider), enter the username in the following format: TenancyName/Federation/UserName. 
# For example, if you use OCI's identity provider, your login would be, Acme/oracleidentitycloudservice/alice.jones@acme.com. 
#If you are using OCI's direct sign-in, enter the username in the following format: TenancyName/YourUserName. For example, Acme/alice_jones. Your password is the auth token you created previously.

oci_user_authtoken = "<oci_user_authtoken>" 
# You can get the auth token from your Profile menu -> click User Settings -> On left side  click *Auth Tokens -> Generate Token

Deploy:

terraform init
terraform plan
terraform apply

Validate the execution

As this a function the validation to be done via logs . Use OCI Logs for function execution and watch for logs like below .

"Invoked function with default  image" and 
"Invoked function with custom image" 

Destroy the Deployment

When you no longer need the deployment, you can run this command to destroy it:

terraform destroy