updating links for CRAN

Author: hongooi73

.Rbuildignore

@@ -5,6 +5,7 @@
 \.Rxproj$
 ^\.Rproj\.user$
 CONTRIBUTING.md
+SECURITY.md
 drat.sh
 .travis.yml
 ^LICENSE\.md$

DESCRIPTION

@@ -1,13 +1,13 @@
 Package: AzureContainers
 Title: Interface to 'Container Instances', 'Docker Registry' and 'Kubernetes' in 'Azure'
-Version: 1.3.2
+Version: 1.3.3
 Authors@R: c(
     person("Hong", "Ooi", , "[email protected]", role = c("aut", "cre")),
     person("Bill", "Liang", role = "ctb", comment = "Assistance debugging MMLS on Kubernetes"),
     person("Ramkumar", "Chandrasekaran", role = "ctb", comment = "Original blog article on Dockerising MMLS"),
     person("Microsoft", role="cph")
     )
-Description: An interface to container functionality in Microsoft's 'Azure' cloud: <https://azure.microsoft.com/en-us/product-categories/containers/>. Manage 'Azure Container Instance' (ACI), 'Azure Container Registry' (ACR) and 'Azure Kubernetes Service' (AKS) resources, push and pull images, and deploy services. On the client side, lightweight shells to the 'docker', 'docker-compose', 'kubectl' and 'helm' commandline tools are provided. Part of the 'AzureR' family of packages.
+Description: An interface to container functionality in Microsoft's 'Azure' cloud: <https://azure.microsoft.com/en-us/products/category/containers/>. Manage 'Azure Container Instance' (ACI), 'Azure Container Registry' (ACR) and 'Azure Kubernetes Service' (AKS) resources, push and pull images, and deploy services. On the client side, lightweight shells to the 'docker', 'docker-compose', 'kubectl' and 'helm' commandline tools are provided. Part of the 'AzureR' family of packages.
 URL: https://github.com/Azure/AzureContainers https://github.com/Azure/AzureR
 BugReports: https://github.com/Azure/AzureContainers/issues
 License: MIT + file LICENSE
@@ -34,4 +34,4 @@ Suggests:
     RestRserve,
     AzureKeyVault
 Roxygen: list(markdown=TRUE, r6=FALSE, old_usage=TRUE)
-RoxygenNote: 7.1.1
+RoxygenNote: 7.3.1

NEWS.md

@@ -1,3 +1,7 @@
+# AzureContainers 1.3.3
+
+- Updated web links for CRAN
+
 # AzureContainers 1.3.2
 
 - Add a `secure_env_vars` argument to the `create_aci()` method, to set secure environment variables in the instance.  The values of these variables are not visible in the container's properties, eg when viewed in the Azure portal or via the CLI.
@@ -42,7 +46,7 @@
 
 # AzureContainers 1.1.1
 
-* Enable creating ACI and AKS instances with assigned managed identities. Note that this is still in preview for AKS; see the [Microsoft Docs page](https://docs.microsoft.com/en-us/azure/aks/use-managed-identity) for enabling this feature.
+* Enable creating ACI and AKS instances with assigned managed identities. Note that this is still in preview for AKS; see the [Microsoft Docs page](https://learn.microsoft.com/en-us/azure/aks/use-managed-identity) for enabling this feature.
 
 # AzureContainers 1.1.0
 

R/add_aci_methods.R

@@ -26,18 +26,18 @@
 #' - `cores`: The number of CPU cores for the instance.
 #' - `memory`: The memory size in GB for the instance.
 #' - `os`: The operating system to run in the instance.
-#' - `command`: A list of commands to run in the instance. This is similar to the `--entrypoint` commandline argument to `docker run`; see [here](https://docs.microsoft.com/en-us/azure/container-instances/container-instances-start-command) for some examples.
+#' - `command`: A list of commands to run in the instance. This is similar to the `--entrypoint` commandline argument to `docker run`; see [here](https://learn.microsoft.com/en-us/azure/container-instances/container-instances-start-command) for some examples.
 #' - `env_vars`: A list of name-value pairs to set as environment variables in the instance.
 #' - `secure_env_vars`: A list of name-value pairs to set as _secure_ environment variables in the instance. The values of these variables are not visible in the container's properties, eg when viewed in the Azure portal or via the CLI.
 #' - `ports`: The network ports to open. By default, opens ports 80 and 443. See 'Details'.
 #' - `dns_name`: The domain name prefix for the instance. Only takes effect if `public_ip=TRUE`.
 #' - `public_ip`: Whether the instance should be publicly accessible.
 #' - `restart`: Whether to restart the instance should an event occur.
 #' - `managed_identity`: Whether to assign the container instance a managed identity.
-#' - `...`: Other named arguments to pass to the [az_resource] initialization function.
+#' - `...`: Other named arguments to pass to the [AzureRMR::az_resource] initialization function.
 #'
 #' @section Details:
-#' An ACI resource is a running container hosted in Azure. See the [documentation for the resource](https://docs.microsoft.com/en-us/azure/container-instances/) for more information. Currently ACI only supports a single image in an instance.
+#' An ACI resource is a running container hosted in Azure. See the [documentation for the resource](https://learn.microsoft.com/en-us/azure/container-instances/) for more information. Currently ACI only supports a single image in an instance.
 #'
 #' To supply the registry authentication credentials, the `registry_creds` argument should contain either an [ACR][acr] object, a [docker_registry] object, or the result of a call to the [aci_creds] function.
 #'
@@ -51,8 +51,8 @@
 #'
 #' [az_container_instance]
 #'
-#' [ACI documentation](https://docs.microsoft.com/en-us/azure/container-instances/) and
-#' [API reference](https://docs.microsoft.com/en-us/rest/api/container-instances/)
+#' [ACI documentation](https://learn.microsoft.com/en-us/azure/container-instances/) and
+#' [API reference](https://learn.microsoft.com/en-us/rest/api/container-instances/)
 #'
 #' [Docker commandline reference](https://docs.docker.com/engine/reference/commandline/cli/)
 #'
@@ -103,8 +103,8 @@ NULL
 #'
 #' [az_container_instance]
 #'
-#' [ACI documentation](https://docs.microsoft.com/en-us/azure/container-instances/) and
-#' [API reference](https://docs.microsoft.com/en-us/rest/api/container-instances/)
+#' [ACI documentation](https://learn.microsoft.com/en-us/azure/container-instances/) and
+#' [API reference](https://learn.microsoft.com/en-us/rest/api/container-instances/)
 #'
 #' [Docker commandline reference](https://docs.docker.com/engine/reference/commandline/cli/)
 #'
@@ -146,8 +146,8 @@ NULL
 #'
 #' [az_container_instance]
 #'
-#' [ACI documentation](https://docs.microsoft.com/en-us/azure/container-instances/) and
-#' [API reference](https://docs.microsoft.com/en-us/rest/api/container-instances/)
+#' [ACI documentation](https://learn.microsoft.com/en-us/azure/container-instances/) and
+#' [API reference](https://learn.microsoft.com/en-us/rest/api/container-instances/)
 #'
 #' [Docker commandline reference](https://docs.docker.com/engine/reference/commandline/cli/)
 #'

R/add_acr_methods.R

@@ -16,10 +16,10 @@
 #' - `admin_user_enabled`: Whether to enable the Admin user. Currently this must be `TRUE` for ACI to pull from the registry.
 #' - `sku`: Either "Basic", "Standard" (the default) or "Premium".
 #' - `wait`: Whether to wait until the ACR resource provisioning is complete.
-#' - `...`: Other named arguments to pass to the [az_resource] initialization function.
+#' - `...`: Other named arguments to pass to the [AzureRMR::az_resource] initialization function.
 #'
 #' @section Details:
-#' An ACR resource is a Docker registry hosted in Azure. See the [documentation for the resource](https://docs.microsoft.com/en-us/azure/container-registry/) for more information. To work with the registry (transfer images, retag images, etc) see the [documentation for the registry endpoint][docker_registry].
+#' An ACR resource is a Docker registry hosted in Azure. See the [documentation for the resource](https://learn.microsoft.com/en-us/azure/container-registry/) for more information. To work with the registry (transfer images, retag images, etc) see the [documentation for the registry endpoint][docker_registry].
 #'
 #' @section Value:
 #' An object of class `az_container_registry` representing the registry resource.
@@ -31,8 +31,8 @@
 #'
 #' [docker_registry] for the registry endpoint
 #'
-#' [ACR documentation](https://docs.microsoft.com/en-us/azure/container-registry/) and
-#' [API reference](https://docs.microsoft.com/en-us/rest/api/containerregistry/registries)
+#' [ACR documentation](https://learn.microsoft.com/en-us/azure/container-registry/) and
+#' [API reference](https://learn.microsoft.com/en-us/rest/api/containerregistry/registries)
 #'
 #' [Docker registry API](https://docs.docker.com/registry/spec/api/)
 #'
@@ -80,8 +80,8 @@ NULL
 #'
 #' [docker_registry] for the registry endpoint
 #'
-#' [ACR documentation](https://docs.microsoft.com/en-us/azure/container-registry/) and
-#' [API reference](https://docs.microsoft.com/en-us/rest/api/containerregistry/registries)
+#' [ACR documentation](https://learn.microsoft.com/en-us/azure/container-registry/) and
+#' [API reference](https://learn.microsoft.com/en-us/rest/api/containerregistry/registries)
 #'
 #' [Docker registry API](https://docs.docker.com/registry/spec/api/)
 #'
@@ -125,8 +125,8 @@ NULL
 #'
 #' [docker_registry] for the registry endpoint
 #'
-#' [ACR documentation](https://docs.microsoft.com/en-us/azure/container-registry/) and
-#' [API reference](https://docs.microsoft.com/en-us/rest/api/containerregistry/registries)
+#' [ACR documentation](https://learn.microsoft.com/en-us/azure/container-registry/) and
+#' [API reference](https://learn.microsoft.com/en-us/rest/api/containerregistry/registries)
 #'
 #' [Docker registry API](https://docs.docker.com/registry/spec/api/)
 #'

R/add_aks_methods.R

@@ -35,7 +35,7 @@
 #'
 #' The nodes for an AKS cluster are organised into _agent pools_, also known as _node pools_, which are homogenous groups of virtual machines. To specify the details for a single agent pool, use the `agent_pool` function, which returns an S3 object of that class. To specify the details for multiple pools, you can supply a list of such objects, or a single call to the `aks_pools` function; see the examples below. Note that `aks_pools` is older, and does not support all the possible parameters for an agent pool.
 #'
-#' Of the agent pools in a cluster, at least one must be a _system pool_, which is used to host critical system pods such as CoreDNS and tunnelfront. If you specify more than one pool, the first pool will be treated as the system pool. Note that there are certain [extra requirements](https://docs.microsoft.com/en-us/azure/aks/use-system-pools) for the system pool.
+#' Of the agent pools in a cluster, at least one must be a _system pool_, which is used to host critical system pods such as CoreDNS and tunnelfront. If you specify more than one pool, the first pool will be treated as the system pool. Note that there are certain [extra requirements](https://learn.microsoft.com/en-us/azure/aks/use-system-pools) for the system pool.
 #'
 #' An AKS cluster requires an identity to manage the low-level resources it uses, such as virtual machines and networks. The default and recommended method is to use a _managed identity_, in which all the details of this process are handled by AKS. In AzureContainers version 1.2.1 and older, a _service principal_ was used instead, which is an older and less automated method. By setting `managed_identity=FALSE`, you can continue using a service principal instead of a managed identity.
 #'
@@ -51,8 +51,8 @@
 #'
 #' [kubernetes_cluster] for the cluster endpoint
 #'
-#' [AKS documentation](https://docs.microsoft.com/en-us/azure/aks/) and
-#' [API reference](https://docs.microsoft.com/en-us/rest/api/aks/)
+#' [AKS documentation](https://learn.microsoft.com/en-us/azure/aks/) and
+#' [API reference](https://learn.microsoft.com/en-us/rest/api/aks/)
 #'
 #' [Kubernetes reference](https://kubernetes.io/docs/reference/)
 #'
@@ -113,8 +113,8 @@ NULL
 #'
 #' [kubernetes_cluster] for the cluster endpoint
 #'
-#' [AKS documentation](https://docs.microsoft.com/en-us/azure/aks/) and
-#' [API reference](https://docs.microsoft.com/en-us/rest/api/aks/)
+#' [AKS documentation](https://learn.microsoft.com/en-us/azure/aks/) and
+#' [API reference](https://learn.microsoft.com/en-us/rest/api/aks/)
 #'
 #' [Kubernetes reference](https://kubernetes.io/docs/reference/)
 #'
@@ -158,8 +158,8 @@ NULL
 #'
 #' [kubernetes_cluster] for the cluster endpoint
 #'
-#' [AKS documentation](https://docs.microsoft.com/en-us/azure/aks/) and
-#' [API reference](https://docs.microsoft.com/en-us/rest/api/aks/)
+#' [AKS documentation](https://learn.microsoft.com/en-us/azure/aks/) and
+#' [API reference](https://learn.microsoft.com/en-us/rest/api/aks/)
 #'
 #' [Kubernetes reference](https://kubernetes.io/docs/reference/)
 #'

R/az_container_instance.R

@@ -10,13 +10,13 @@
 #' - `stop()`: Stop a container.
 #'
 #' @section Details:
-#' Initializing a new object of this class can either retrieve an existing ACI resource, or create a new resource on the host. Generally, the best way to initialize an object is via the `get_aci`, `create_aci` or `list_acis` methods of the [az_resource_group] class, which handle the details automatically.
+#' Initializing a new object of this class can either retrieve an existing ACI resource, or create a new resource on the host. Generally, the best way to initialize an object is via the `get_aci`, `create_aci` or `list_acis` methods of the [AzureRMR::az_resource_group] class, which handle the details automatically.
 #'
 #' @seealso
 #' [acr], [aks]
 #'
-#' [ACI documentation](https://docs.microsoft.com/en-us/azure/container-instances/) and
-#' [API reference](https://docs.microsoft.com/en-us/rest/api/container-instances/)
+#' [ACI documentation](https://learn.microsoft.com/en-us/azure/container-instances/) and
+#' [API reference](https://learn.microsoft.com/en-us/rest/api/container-instances/)
 #'
 #' [Docker commandline reference](https://docs.docker.com/engine/reference/commandline/cli/)
 #'

R/az_container_registry.R

@@ -13,7 +13,7 @@
 #' - `get_docker_registry(username, password)`: Return an object representing the Docker registry endpoint.
 #'
 #' @section Details:
-#' Initializing a new object of this class can either retrieve an existing registry resource, or create a new registry on the host. Generally, the best way to initialize an object is via the `get_acr`, `create_acr` or `list_acrs` methods of the [az_resource_group] class, which handle the details automatically.
+#' Initializing a new object of this class can either retrieve an existing registry resource, or create a new registry on the host. Generally, the best way to initialize an object is via the `get_acr`, `create_acr` or `list_acrs` methods of the [AzureRMR::az_resource_group] class, which handle the details automatically.
 #'
 #' Note that this class is separate from the Docker registry itself. This class exposes methods for working with the Azure resource: listing credentials, updating resource tags, updating and deleting the resource, and so on.
 #'
@@ -29,8 +29,8 @@
 #'
 #' [docker_registry] for interacting with the Docker registry endpoint
 #'
-#' [Azure Container Registry](https://docs.microsoft.com/en-us/azure/container-registry/) and
-#' [API reference](https://docs.microsoft.com/en-us/rest/api/containerregistry/registries)
+#' [Azure Container Registry](https://learn.microsoft.com/en-us/azure/container-registry/) and
+#' [API reference](https://learn.microsoft.com/en-us/rest/api/containerregistry/registries)
 #'
 #' @examples
 #' \dontrun{

R/az_kubernetes_service.R

@@ -16,7 +16,7 @@
 #' - `update_service_password(name=NULL, duration=NULL, ...)`: Update the password for the service principal used to manage the cluster resources, returning the new password invisibly.  See 'Updating credentials' below.
 #'
 #' @section Details:
-#' Initializing a new object of this class can either retrieve an existing AKS resource, or create a new resource on the host. Generally, the best way to initialize an object is via the `get_aks`, `create_aks` or `list_aks` methods of the [az_resource_group] class, which handle the details automatically.
+#' Initializing a new object of this class can either retrieve an existing AKS resource, or create a new resource on the host. Generally, the best way to initialize an object is via the `get_aks`, `create_aks` or `list_aks` methods of the [AzureRMR::az_resource_group] class, which handle the details automatically.
 #'
 #' Note that this class is separate from the Kubernetes cluster itself. This class exposes methods for working with the Azure resource: updating resource tags, updating and deleting the resource (including updating the Kubernetes version), and so on.
 #'
@@ -39,8 +39,8 @@
 #'
 #' [kubernetes_cluster] for interacting with the cluster endpoint
 #'
-#' [AKS documentation](https://docs.microsoft.com/en-us/azure/aks/) and
-#' [API reference](https://docs.microsoft.com/en-us/rest/api/aks/)
+#' [AKS documentation](https://learn.microsoft.com/en-us/azure/aks/) and
+#' [API reference](https://learn.microsoft.com/en-us/rest/api/aks/)
 #'
 #' @examples
 #' \dontrun{
@@ -212,7 +212,7 @@ public=list(
 #' @seealso
 #' [create_aks], [list_vm_sizes]
 #'
-#' [Agent pool parameters on Microsoft Docs](https://docs.microsoft.com/en-us/rest/api/aks/managedclusters/createorupdate#managedclusteragentpoolprofile)
+#' [Agent pool parameters on Microsoft Docs](https://learn.microsoft.com/en-us/rest/api/aks/managedclusters/createorupdate#managedclusteragentpoolprofile)
 #'
 #' @examples
 #' # pool of 5 Linux GPU-enabled VMs

README.md

@@ -4,7 +4,7 @@
 ![Downloads](https://cranlogs.r-pkg.org/badges/AzureContainers)
 ![R-CMD-check](https://github.com/Azure/AzureContainers/workflows/R-CMD-check/badge.svg)
 
-A package for working with [Azure Container Registry (ACR)](https://azure.microsoft.com/en-us/services/container-registry/), [Azure Kubernetes Service (AKS)](https://azure.microsoft.com/en-us/services/kubernetes-service/) and [Azure Container Instances (ACI)](https://azure.microsoft.com/en-us/services/container-instances/). Extends the Azure Resource Manager interface provided by the [AzureRMR](https://github.com/Azure/AzureRMR) package.
+A package for working with [Azure Container Registry (ACR)](https://azure.microsoft.com/en-us/products/container-registry/), [Azure Kubernetes Service (AKS)](https://azure.microsoft.com/en-us/products/kubernetes-service/) and [Azure Container Instances (ACI)](https://azure.microsoft.com/en-us/products/container-instances/). Extends the Azure Resource Manager interface provided by the [AzureRMR](https://github.com/Azure/AzureRMR) package.
 
 AzureContainers lets you build and deploy containerised services in R, using Docker and Kubernetes. For full functionality, you should have [Docker](https://docs.docker.com/install/) installed, as well as the [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) and [helm](https://helm.sh/) commandline tools. Otherwise it is relatively lightweight, requiring neither Powershell nor Python.